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 and these docs call this concept a campaign (matching industry vernacular). The REST API uses /api/programs for the same object, so API examples reference programs.

Create a campaign

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

• name (visible to affiliates)
• slug (URL-friendly identifier; used as the campaign's path on your portal, {yourbrand}.rekomi.com/{slug}; you can change it later and the old path redirects to the new one)
• referralDestinationUrl (the website or page affiliates promote; Rekomi appends ?via={slug} to it to build each affiliate's copy-ready link). Campaigns in one organization can point at different websites, so a second site on the same billing account usually just means a second campaign; a different payment-processor account or a different brand means a second organization instead. Affiliates on sale-model campaigns can also create their own product & page links to other products or pages on the same site, up to 20 links per campaign including their main link; you can see every link they've created, with per-link clicks and sales, in the Performance tab's Links section (clicks only on pay-per-click campaigns, where the click itself is the paid unit; on Shopify stores links track clicks and sales with no setup, and coupon-code sales credit the affiliate's account as a whole). Leaving this URL empty turns the feature off, so set it early.
• 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). Cpc/Cpl campaigns can optionally add a sale commission on top (saleCommissionType + saleCommissionValue, percent of sale or flat amount, paid on an attributed customer's first purchase; see Hybrid)
• cookieWindowDays (typically 30, 60, or 90)
• minPayoutCents (per-campaign minimum payout threshold; defaults to $50)

Optional at creation:

• description (shown on the public application page)
• termsUrl (link to your affiliate terms; settable via the API today, shown on the public landing page and invite accept page)
• 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.
• Creator network listing and search-engine listing toggles (whether the campaign appears in the Rekomi network directory and whether its public signup page is indexable)

The campaign detail page

Once created, /dashboard/campaigns/{id} has eight tabs: Overview (the default view), Affiliates, Performance, Commission, Products, Coupons, Promo materials, and Settings. Overview is a summary dashboard for the campaign. Affiliates holds your roster plus a Recruiting section for sub-affiliate setup. Performance groups Activity, Links, Leads, and Fraud into sections of one tab (the Leads section appears once the campaign has leads, or while it has no sales yet; stores connected through Shopify never see it). Commission holds the campaign's rate configuration, Products holds the catalog and per-product rates, and Coupons holds coupon-code attribution. All three show on every campaign; where one doesn't apply (per-product rates on a pay-per-click or pay-per-lead campaign, coupons on a billing provider without coupon support), the tab explains what the feature does and what unlocks it instead of hiding. Promo materials holds the banners and ready-made posts you upload for affiliates. The header shows your public signup page URL with Copy, Open, and Edit landing page actions beside it; the Edit button opens the signup page editor.

(The Commission tab hosts the default commission display, partner groups (rate tiers you assign partners to in bulk), and the performance tier editor. For CPC/CPL campaigns it also shows the live budget spent/remaining meter; the budget cap itself is set on the campaign form in Settings. The Performance tab's Fraud section hosts the fraud review queue.)

Affiliates

Approved and pending affiliates for this campaign. Approve, reject, edit commission overrides per affiliate. A Recruiting section on this tab configures sub-affiliate recruiting; see Recruiting (sub-affiliates).

Commission

Default commission display (set on the Settings tab), partner groups for assigning rate tiers to affiliates in bulk, and the performance-based tiered commission editor (see Commission models). A Product commission rates card is also available on the Products tab on every sale campaign, letting you set a commission rate for a specific product; the rate applies wherever the payment provider reports what was bought: Shopify, Stripe, Gumroad, Lemon Squeezy, Polar, Creem, Dodo, and Braintree subscriptions, ahead of the affiliate's base rate (everything else uses the campaign rate). See Per-product commissions.

Promo materials

Uploads of promotional material for your affiliates: banners and ready-made posts (swipe copy) you add here become visible to approved affiliates from their campaign page. See Creative assets.

Settings

Edit all campaign fields:

• name, description (termsUrl is editable via the API only today)
• 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)
• budgetCents (CPC/CPL campaigns only; optional spend cap, see Pay per click or lead)
• saleCommissionType + saleCommissionValue (CPC/CPL campaigns only; the optional sale-commission add-on, see Hybrid)
• attributionModel (FirstTouch or LastTouch)
• autoApprove (toggle)
• minPayoutCents (per-campaign minimum payout threshold; affiliates accrue until their balance reaches it, and it applies on top of your account-wide minimum)
• Creator network listing and search-engine listing toggles (control whether the campaign appears in the Rekomi network directory and whether its public signup page is indexable)
• Traffic from ads policy: what happens to a sale attributed to an ad-flagged click (an affiliate running paid ads to your site). Allow (the default) counts ad-driven sales like any other; Hold for review parks them in your fraud queue until you approve them; Block pays no commission on them.
• Public leaderboard ("Show a leaderboard to affiliates"): per campaign, off by default. When on, the affiliate campaign page shows the top earners with other affiliates' names masked; each affiliate sees their own row unmasked.
• customSubdomain (every plan): 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.

The URL slug can be renamed from the Campaign URL card at the top of the Settings tab. The old path automatically redirects to the new one, so links your affiliates already shared keep working.

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

Archiving hides the campaign and stops its links from accepting new clicks and sales. Existing records stay for historical reporting. Archiving cannot be undone from the dashboard today; contact support if you need a campaign restored. There is no hard delete. Via the API this is DELETE /api/programs/{id} (Owner role).

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 every plan, the same pages can serve from your own domain (affiliates.yourbrand.com/{slug}). Out of the box the page shows your logo, the campaign name and description, live stats (commission, cookie window, attribution model), a how-it-works section, the terms link, and the application form. The Landing page tab opens a full editor with layout options (centered, split, or hero banner), one-click theme presets including dark palettes, 1,900+ fonts, and content blocks including a product showcase; see Recruit affiliates for the full tour.