Campaigns

A campaign holds your affiliates, sales, commissions, and payouts. Most brands run one campaign. Some run multiple (per product line, per geography, per persona).

Note on naming: the dashboard, marketing site, and these docs all call this concept a campaign (matching industry vernacular used by Rewardful, Tapfiliate, PartnerStack). Internally the REST API still uses /api/programs and the entity type is Program; those internal names stay because changing them mid-life adds friction with zero user benefit.

Create a campaign

From /dashboard/campaigns, click "New campaign". Required:

• name (visible to affiliates)
• slug (URL-friendly identifier; permanent once set; used as the campaign's path on your portal, {yourbrand}.rekomi.com/{slug})
• defaultCommissionType (Percentage or Fixed)
• defaultCommissionValue (percent like 20, or a dollar amount like 10 for $10 / 0.50 for $0.50)
• defaultCommissionModel (Cps for per sale, Cpc for per click, Cpl for per lead; legacy Cpa/RevShare/Hybrid still accepted for existing campaigns; see Commission models)
• cookieWindowDays (typically 30, 60, or 90)

Optional at creation:

• description (shown on the public application page)
• termsUrl (link to your affiliate terms)
• attributionModel (FirstTouch or LastTouch; default LastTouch)
• autoApprove (boolean; if true, applications are approved on submit). Not available for CPC/CPL campaigns: they are invite-only, so auto-approve and the public application page are turned off automatically.

The campaign detail page

Once created, /dashboard/campaigns/{id} has these tabs: Affiliates, Activity, Commissions, Assets, Coupons, Sub-affiliates, Fraud, and Settings. (For CPC/CPL campaigns the Commissions tab also hosts partner groups and the budget cap, and the Fraud tab hosts the fraud review queue.)

Affiliates

Approved and pending affiliates for this campaign. Approve, reject, edit commission overrides per affiliate.

Commissions

Default commission display (set on the Settings tab). Performance-based tiered commission editor (see Commission models).

Assets

Link management for promotional assets your affiliates can use (banners, swipe copy, landing pages).

Settings

Edit all campaign fields:

• name, description, termsUrl
• defaultCommissionType, defaultCommissionValue, defaultCommissionModel
• cookieWindowDays
• recurringMonths (cap recurring payouts; not set/null = lifetime, 0 = one-time, N = first N renewals)
• recurringDelayInvoices (skip the first N invoices before paying commission, useful for trial-heavy products)
• attributionModel (FirstTouch or LastTouch)
• autoApprove (toggle)
• customSubdomain (Growth): publish your portal on a domain you own (e.g. affiliates.yourbrand.com) instead of the free {yourbrand}.rekomi.com. Each campaign keeps its clean path (affiliates.yourbrand.com/{slug}). See Settings → Custom affiliate-portal subdomain for the DNS-verification flow.

Slug is not editable. To rename a campaign slug, archive and recreate.

Recurring commission settings

For subscription products, the default commission applies to every renewal for the life of the subscription. The campaign form's "How long affiliates earn per customer" control sets this; the underlying field is recurringMonths:

• not set / lifetime (default): pay on every renewal as long as the subscription stays active.
• recurringMonths = 0: one-time. Pay on the first invoice only; no renewals.
• recurringMonths = 12: pay on the first 12 renewals, then stop.
• recurringMonths = 3: pay on the first 3.

recurringDelayInvoices lets you skip the first N invoices. Common pattern: trial-to-paid products often refund the first invoice if a customer churns, so setting recurringDelayInvoices = 1 reduces clawback exposure.

Archive

Soft delete via DELETE /api/programs/{id}. Sets ArchivedAt. Existing tracking links keep working for the attribution window. Archived campaigns disappear from the dashboard but remain in the database for historical reporting. There is no hard delete.

Public landing page

Every active campaign has a public landing page on your branded portal: your primary campaign at {yourbrand}.rekomi.com/ and every other campaign at {yourbrand}.rekomi.com/{slug}. On Growth, the same pages serve from your own domain (affiliates.yourbrand.com/{slug}). The page renders the campaign name, description, commission type and value, cookie window, attribution model, terms link, and an application form. See Recruit affiliates for what shows up and what you can customize.