Migrate from FirstPromoter

Migrate from FirstPromoter

Migrate your program into Referly

Move in an afternoon. Rebuild one thing properly.

Referly imports directly from FirstPromoter. The email sequences are the part that needs planning.

14-day free trialNo credit card requiredMigration is free on every plan

Connect FirstPromoter

Not connectedConnected

API key

fp_live_...

Your FirstPromoter API key.

Account ID

acct_123

Referly validates the connection before it imports anything.

Connect

What to bring across

Affiliatesnames, emails, links, rates, join dates
Referralscustomers, with the affiliate who referred them
Salesamounts, commissions, paid status, original dates

Imports

ProcessingCompleted
AffiliatesFirstPromoter API1543987061,0141,284 / 1,284
1,284 imported0 failedReferral codes preserved
ReferralsQueued, runs next
SalesQueued, runs last

Affiliates, then referrals, then sales. Referly runs them in that order because a referral needs its affiliate and a sale needs both.

Referly imports directly from FirstPromoter. Take your API key and Account ID from Settings, run the importer, and affiliates arrive with their codes, rates and join dates. Two things need rebuilding by hand: your commission plans, and your affiliate email automation. Run both tools for a few days, then switch. Migration is free on every plan.

Before you start

What comes across, and what doesn't

The losses are listed first on purpose. One of them is a feature you probably chose FirstPromoter for.

Stays behind

Affiliate email automation

FirstPromoter's built-in sequences are the feature their customers name most often, and there is no importing them. Referly has announcements, email notifications and integrations with MailerLite, Klaviyo, Brevo and Mailchimp, which is a different shape. Plan to rebuild, not to migrate.

Stays behind

Commission plans and campaign rules

Readable in FirstPromoter, but there is nothing to import them into. On Starter you are capped at three campaigns anyway, so most programs arriving here are rebuilding two or three things, not twenty.

Stays behind

The historic click log

Not importable from any tool. Click-through and conversion-rate charts start on cutover day.

Stays behind

Portal customisation and custom CSS

Rebuilt. Referly's portal takes branding, custom CSS and a custom domain, but none of it transfers.

Comes across

Affiliates and their details

Names, emails, payout emails, status and countries, over the API.

Comes across

Referral codes and links

The code survives the move. What changes is the domain it points at.

Comes across

Per-affiliate commission rates

Individual rates arrive as per-affiliate overrides rather than flattening to one program rate.

Comes across

Customers, sales and commissions

With their original dates, so the history you built on FirstPromoter is still the history you report on.

Partly

Paid payouts

Sales you import can carry their paid status, so nobody is paid twice. The payout records themselves stay behind.

Partly

Unpaid commissions

Import them marked unpaid and pay from Referly, or pay them out of FirstPromoter first.

No importer in this category carries commission plans, including ours. On this migration there is a second thing on that list, and it is better to know now than in week two.

Step 1

Where your FirstPromoter credentials live

FirstPromoter needs two values rather than one, which is why Referly's setup screen asks for two fields. Both sit in the same panel.

FirstPromoter also offers to run the migration for you off a CSV, and quotes 24 to 48 hours for it. That is a good offer. The API route is here because it is faster and you can run it yourself, not because theirs is bad.

In FirstPromoter

  1. 1

    Settings → Integrations → Manage API Keys

    Copy your API key.

  2. 2

    Settings → Integrations

    Copy your Account ID, in the same panel.

How Referly authenticates

Bearer token plus an ACCOUNT-ID header. FirstPromoter needs both, which is why Referly's setup screen asks for two fields rather than one.

Source: FirstPromoter's API authentication docs, checked 2026-08-10.

New announcement

Draft

Subject

Your new links are live

Message

We have moved the program to Referly. Your code is unchanged, your history came across, and your new link is in your dashboard. Please update it wherever you have posted the old one.
AudienceEveryoneImported affiliates · 1,284Also send by emailOn

Shows in the portal and lands in their inbox.

Send announcement

Sent to 1,284 affiliates

68% opened

One batch, during the overlap. This is the message that gets the new link in front of everyone before the old tool goes dark.

The thing you are rebuilding

What replaces the email sequences

FirstPromoter's affiliate email automation is good, and this is not a claim to have matched it. What Referly gives you is announcements that land in the portal and in the inbox, targeted at a segment rather than everyone, with open rates on the other side, plus native connections to MailerLite, Klaviyo, Brevo and Mailchimp for anything that needs a real sequence. During a migration the first of those matters most: one announcement, to the imported affiliates, with their new link in it.

  • Target a group, a commission plan or just the affiliates you imported
  • Shows in the portal and sends by email, from your own sending domain
  • Push the roster into MailerLite, Klaviyo, Brevo or Mailchimp for longer sequences

A custom email sending domain is on Business and above. On Startup announcements still send, from Referly's domain.

The migration

How the migration works

Two hours of work, then a week of watching two dashboards agree with each other.

1Scope and plan

~30 min

List your campaigns, commission rules and open payouts. Decide what happens to commissions accrued but not yet paid.

2Export and map

~30 min

Export affiliates from FirstPromoter. Referly's direct FirstPromoter importer maps affiliates, their referral links and their commission rates.

3Configure and import

~1 hour

Recreate your commission plans in Referly, run the import, and swap the tracking script and the payment connection.

4Verify and go live

3 to 7 days overlap

Run both in parallel, compare attributed sales daily, then switch off FirstPromoter.

about two hoursthen 3 to 7 days running both, so you can compare the numbers before you switch anything off.Free on every plan
1

Scope and plan

List your campaigns, commission rules and open payouts. Decide what happens to commissions accrued but not yet paid.

2

Export and map

Export affiliates from FirstPromoter. Referly's direct FirstPromoter importer maps affiliates, their referral links and their commission rates.

3

Configure and import

Recreate your commission plans in Referly, run the import, and swap the tracking script and the payment connection.

4

Verify and go live

Run both in parallel, compare attributed sales daily, then switch off FirstPromoter.

about two hours, then 3 to 7 days running both tools side by side.

Referral codes

The codes survive, and so does the old parameter

FirstPromoter puts the affiliate's code in ?fpr=, and both ?fpr= and ?fp_ref= are already in the list of parameters Referly's tracking script reads. So during the overlap, a FirstPromoter-shaped link landing on your site resolves to the right affiliate without anyone republishing anything. That is a grace period, not a permanent fix: links pointing at FirstPromoter's own domain stop working the day you switch it off.

?fpr= is already in the tracker

In FirstPromoter

Maya Bergströmmaya

firstpromoter.com/?fpr=maya

In Referly

Maya Bergströmmaya

yourbrand.com/?ref=maya

Same code. New domain. Her join date comes across too.

Referly's tracking script reads

?ref=?fpr=?partner=and 30 more

FirstPromoter's own ?fpr= parameter is one of them, so a FirstPromoter-shaped link landing on your site still resolves to the right affiliate.

Connected integrations

One program
StripeSubscriptions, one-off payments, couponsConnected
ShopifyOrders, discount codes, refundsConnectConnected
WooCommerceOrders and couponsConnect
PaddleSubscriptionsConnect
ChargebeeSubscriptionsConnect
PolarCheckout and payment linksConnect

Install Referly on your store

Referly will read orders, discount codes and refunds so it can attribute sales and reverse commissions automatically.

CancelInstall app

Both sides, one program. A SaaS subscription in Stripe and a store order in Shopify pay the same affiliate, from the same commission plan, into the same payout.

If you have added a store

FirstPromoter has no Shopify support at any plan

Stripe, Chargebee and Paddle, and that is the list. For a pure SaaS program it is a fine list. For anyone who has added a store, or is about to, it is the reason this page exists. Referly tracks subscriptions and store orders on one program, so the same affiliate is paid from both without running two tools and reconciling them by hand.

  • Stripe and Shopify both connect by OAuth
  • WooCommerce, Paddle, Chargebee and Polar alongside them
  • One roster, one commission plan, one payout run

Customer stories

Take their word for it

The founders and affiliate managers behind three fast-growing programs, in their own words.

Moov
EcommerceFitness

Affiliates drive a serious share of our revenue across three countries. Since we moved to Referly everything runs from one place, tracking has been spot on, and our partners get paid without me chasing spreadsheets.

Alexander Koppers

Alexander Koppers

Affiliate Manager, Moov

$6.9M

in total affiliate-driven revenue

1,154
active affiliates
19,017
affiliate sales
1,240,030
clicks tracked
OptimizePress
SaaSSite builder

We have been running affiliate programs for over a decade, and ours is one of the biggest parts of how OptimizePress grows. Referly is the first platform where an operation with thousands of partners actually feels manageable, from recruiting new affiliates to tracking every sale they send.

James Dyson

James Dyson

Founder & CEO, OptimizePress

7 figures
in affiliate-driven sales
4,554
active affiliates
10,536
referrals
Letterly
Mobile appAI writing

This platform is quite simple and easy to use, and you can start attracting people to your affiliate program very quickly. A big plus is that the founder, Ayo, is super responsive.

Ilfat Khayrullin

Ilfat Khayrullin

CMO & Co-founder, Letterly

300K+
app users
689
active affiliates
24,114
clicks tracked

Plan your move

Where each plan runs out

FirstPromoter and Referly both meter on affiliate revenue, so the honest comparison is not the sticker price but where your program hits the next tier. Move the slider to your own number.

$8,000

ReferlyReferly

Startup$75
Business$149
Enterprise (from $399/mo, billed yearly)$399

FirstPromoter

Starter$49
Business$99
Enterprise$149
Referly

Referly

Startup

$75/mo

FirstPromoter

Business

$99/mo

The dashed line is your revenue crossing each ladder. At $8,000/mo, Referly bills $75 and FirstPromoter bills $99.

Last step

Before you cancel: export a copy of everything

Pull a CSV of affiliates, referrals, commissions and payout history out of FirstPromoter and keep it somewhere durable. Data access usually closes at cancellation, and the copy costs you nothing.

Cancel from your FirstPromoter billing settings once the overlap is finished and the two dashboards agree on attributed sales. Not before: while FirstPromoter is running, links your affiliates posted months ago still resolve.

Worth saying plainly, because it is true and this page has nothing to gain by hiding it: FirstPromoter will run the migration for you off a CSV, and quotes 24 to 48 hours for it. If you would rather hand it over than do it yourself, that is a real option and a good offer.

Migration help

Migration help, free on every plan

Direct import or CSV, Startup or Enterprise, moving costs nothing. Bring your export, a list of the campaigns and sequences you need rebuilt, and a cutover date, and we will plan it with you.

Managed, done-for-you migration is part of Enterprise and the agency plans rather than every tier. For context: Trackdesk includes migration and implementation assistance from its Business plan, at $329 a month.

FAQ

Migration questions

Answered as honestly and as accurately as we can, including the parts that are work.

14-day free trial · No credit card required · Cancel anytime

  • About two hours of hands-on work, then three to seven days running both tools in parallel. The import takes minutes. The time goes on rebuilding your commission plans and your email sequences, neither of which any importer carries.