Campaigns

What this section is for

Campaigns distribute individualised codes to humans — for example, presale ticket codes for a partner event. Each code is unique, belongs to exactly one campaign, and is assigned to at most one human.

A campaign bundles three things: the codes (imported in bulk or generated through the ticket vendor), the grants that link a code to a human, and the email waves that deliver those codes. You can always look up your codes on your own profile, and anyone can opt out of campaign emails via the unsubscribe link in every send.

Key pages at a glance

My codes — a section on your profile (/Profile/Me) listing every campaign grant assigned to you
Unsubscribe (/Unsubscribe/{token}) — public, no-login page to opt out of all future campaign emails
Campaigns list (/Campaigns/Admin) — every campaign with its status and code and grant counts
Campaign detail (/Campaigns/Admin/{id}) — stats (total codes, available, sent, failed, redeemed) and the grant table; entry point for Import Codes, Generate Codes (vendor), Activate, Send Wave, Complete, Resend, and Retry All Failed
Create campaign (/Campaigns/Admin/Create) — form for title, description, email subject, email body template (markdown, supports {{Code}} and {{Name}}), and optional Reply-To address
Import codes — CSV upload for code values, available on Draft and Active campaigns
Generate codes — vendor-issued discount codes (count, type, value), Draft campaigns only; available to TicketAdmin and Admin
Send wave (/Campaigns/Admin/{id}/SendWave) — targets a single team, assigns free codes to eligible humans, and queues the emails

As a Volunteer

See the codes you have been granted

Open your profile at /Profile/Me and look for the My Codes section. It lists every campaign grant on your account, with the campaign and the code value. Codes stay visible here even after you have used the one in the email, so if you lose the message, this is where to look.

![TODO: screenshot — My Codes section on /Profile/Me showing a campaign grant with its title and code value]

Receive a campaign email

When an Admin sends a wave that includes you, the code arrives by email to your notification address. The message carries the code, the campaign's description, and an unsubscribe link (plus a List-Unsubscribe header).

Unsubscribe from campaign emails

Click the unsubscribe link in any campaign email. It takes you to /Unsubscribe/{token} — public, no login needed. New category-aware tokens redirect you to the public communication-preferences page where you can toggle which categories you receive; legacy campaign-only tokens show a confirmation page where you POST to confirm. Either path flips your Campaign Codes (or, for legacy tokens, Marketing) preference to opted-out and excludes you from future wave sends. RFC 8058 one-click unsubscribe is also supported via the List-Unsubscribe header. Unsubscribing does not remove codes already granted to you, and it only affects future campaign emails.

Profiles — the My Codes list lives on your profile; opt-out is managed from Communication Preferences (the legacy UnsubscribedFromCampaigns flag is retained for GDPR export but no longer the active gate)
Onboarding — only active, non-suspended humans on targeted teams are eligible for waves