FirstPromoter
AdvertisingRun affiliate operations in FirstPromoter without manual bookkeeping. Agents create and update promoters, track referral signups and sales, and review referrals and commissions so payouts stay accurate.
What This Integration Enables
Affiliate programs run on a simple promise: send us customers and we will pay you accurately. Every attribution gap breaks that promise, and broken promises are why promoters quit promoting. FlowRunner agents make the bookkeeping side of the promise mechanical. They create and update promoters from application flows, register signups the moment referred users convert, record sales with duplicate-proof event IDs so commissions calculate correctly, and pull referrals and commissions for the reconciliation and payout work that keeps the program trusted.
- Onboard applicants from Typeform into promoters with generated referral links
- Attribute signups the moment a referred user converts, before the cookie is gone
- Record Stripe purchases and renewals as tracked sales with commission calculation
- Build monthly payout reports in Google Sheets from commission data
- Audit referral activity per promoter and campaign for reconciliation
- Notify the finance team in Slack when the payout file is ready for review
The unglamorous part is the point. Affiliate managers should spend their time recruiting promoters and improving offers, not reconciling ledgers, and promoters who see accurate commissions land without chasing anyone promote harder. Accurate bookkeeping is not the program's overhead. It is the program's retention strategy.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Application to referral link before interest fades
An affiliate application arrives via Typeform. The agent checks List Promoters for an existing account under that email, then calls Create Promoter with the applicant's details, campaign, and a clean referral token. The response includes their live referral link, which goes out in the welcome email along with program terms. An applicant who was excited at 2 pm is promoting by 2:15, instead of cooling off in a review queue for a week.
The billing event that carries its attribution
Stripe records a new subscription. The flow calls Track Sale with the customer's email, the charge amount in cents, and the Stripe event ID as the unique event ID, so webhook retries can never mint a duplicate commission. Renewals run through the same path each cycle. Attribution stops being a monthly reconstruction project because every dollar arrived already attributed.
Payout day without the spreadsheet archaeology
On the first of the month, List Commissions pulls everything in a payable state, grouped by promoter with amounts and currencies. The agent cross-checks each promoter's state via List Promoters, flags anomalies, a commission on a refunded charge, a promoter whose earnings tripled in a week, and writes the payout sheet to Google Sheets. The affiliate manager reviews the flags, approves the file, and finance pays it. The program's most sensitive ritual becomes a twenty-minute review instead of a two-day audit.
Human-in-Loop Highlight
Track Sale creates money owed to another business the instant it runs: the recorded amount drives a commission calculation, the commission becomes a payable balance, and payable balances become transfers to promoters who will, reasonably, spend them. Clawing back an overpaid commission from an affiliate is somewhere between awkward and impossible, so the discipline lives in two places. In the flow itself, every Track Sale carries a unique event ID, which makes duplicate commissions structurally impossible on retries rather than merely unlikely. And at the month's edge, the payout run never goes straight from List Commissions to a bank file: the affiliate manager reviews the assembled report with the agent's anomaly flags attached, the tripled earner, the commission whose underlying charge was refunded, before a single payout is approved. Update Promoter sits behind the same judgment when the field being changed is approval state, because activating a promoter is the decision to start owing them money.
Agent Capabilities
26 actionsCampaigns
2- List Campaigns Lists the affiliate campaigns on the account with signup URL, cookie window, and aggregate stats for referrals, sales, customers, promoters, and revenue. The lookup that supplies the campaign ID every other write needs.
- Get Campaign Retrieves one campaign with its landing URL, referral token parameter, cookie lifetime, tracking links, and the reward structures configured for promoters and referrals. The read that tells an agent what a program actually pays before it onboards anyone into it.
Promoters
10- List Promoters Lists affiliates with pagination and filters by campaign, state, and search term, returning each profile with referral link, contact details, and aggregate earnings. The roster read behind audits and payout checks.
- Get Promoter Retrieves one promoter by FirstPromoter ID, customer ID, or email, with full profile, referral tokens, state, and earnings. The standing check before recording sales or changing anything.
- Find Promoter Retrieves a promoter by any identifier the outside world knows them by: email, your user ID, username, customer ID, referral token, auth token, or promo code. Returns the full record including fraud suspicions and aggregate statistics. Used when your own system knows the affiliate by something other than a FirstPromoter ID.
- Create Promoter Creates a new affiliate from at minimum an email, with optional customer ID, referral token, campaign, and profile details, returning the generated referral link. The onboarding write behind application flows.
- Update Promoter Updates an existing promoter's contact details, customer ID, referral token, or approval state, changing only the provided fields. Approval state changes get a human confirmation, because they open the commission tap.
- Accept Promoters Approves pending promoters into a campaign in bulk so they can start referring, returning a pollable batch process for large lists. The write that turns an application queue into an active affiliate roster.
- Reject Promoters Declines pending applications in bulk without blocking the accounts. Used to clear applicants who do not meet program criteria while leaving the door open.
- Block Promoters Blocks promoters in a campaign, stopping referral tracking and halting further commission accrual. The containment write when fraud is suspected or terms are breached.
- Archive Promoters Archives promoters out of active reporting without deleting their history, and they can be restored later. The tidy-up that does not cost you the past commission record.
- Move Promoters To Campaign Moves promoters between campaigns, optionally carrying their existing referrals across and controlling whether onboarding drip emails fire. Used when restructuring programs or promoting affiliates to a higher tier, and the drip-email switch is the part worth reading twice.
Referrals
3- List Referrals Lists referred leads and customers with filters by promoter, campaign, and state, including customer details and timestamps. The audit read for reconciling signups against attribution.
- Search Referrals Searches referrals with free-text query plus lead or customer type, promoter, and lifecycle state, returning entry source, split commission details, and the promoter campaign each belongs to. The richer read, and the one to reach for first.
- Create Referral Creates a referral against a promoter's campaign entry, attributing a lead or customer to that affiliate, with optional percentage splits across several promoter campaigns. Used to record an attribution your own system determined rather than one the cookie caught.
Commissions
3- List Commissions Lists recorded earnings with filters by promoter, campaign, and state, returning amount, currency, associated referral and promoter, and payout state. The source of every payout report.
- Approve Commissions Approves pending commissions in bulk so they become payable. Run once the refund window has passed and the underlying sales are confirmed, because the next step after this is money leaving.
- Deny Commissions Denies commissions in bulk so they are never paid, after a refund, a chargeback, or a policy breach. The write that takes back an expectation an affiliate has already formed.
Payouts
3- Generate Payouts Turns a set of approved commissions into payment records, grouped per promoter. The end-of-period write that converts a ledger into amounts someone is about to send.
- List Payouts Lists payouts filtered by status or campaign, each with amount, period, method, and owning promoter. The reconciliation read for what has been paid and what is outstanding.
- Mark Payouts As Paid Marks payouts paid in bulk after the money has moved outside FirstPromoter, keeping the affiliate ledger honest about what has actually settled.
Rewards
1- List Rewards Lists the reward structures on the account, scoped to promoter rewards or referral rewards, with each one's name, unit, tier configuration, and attached coupon. The read that explains why a commission came out the size it did.
Tracking
4- Track Signup Registers a referral signup, attributing a new lead or customer to a promoter using the customer's email, your unique customer identifier, and the referral token from the visitor's tracking cookie. Fired at the moment of signup, while the attribution still exists to capture.
- Track Sale Records a sale so a commission calculates for the referring promoter, with the amount in the smallest currency unit and a unique event ID that prevents duplicates on retries. The write that creates money owed, and the reason payout runs end at a human.
- Track Refund Records a refund against a previously tracked sale, identified by its event ID, so the affiliate's commission reverses. Without this call the ledger keeps paying for revenue the business gave back.
- Track Cancellation Records that a referred customer canceled their subscription, ending future recurring commissions for the referring promoter. The write that stops an annuity at the right month rather than three months late.
Triggers
1 triggersEvent Triggers
1- On Account Event Fires when a chosen event happens in the FirstPromoter account: a promoter created, a referral converting, a commission approved. FirstPromoter registers a webhook and the flow runs each time a matching event is delivered, optionally scoped to a single campaign. This is what lets an affiliate program react at the speed the affiliate experiences it, rather than at the speed of the next weekly review.
Frequently Asked Questions
What can FlowRunner do with FirstPromoter?
FlowRunner agents can run List Promoters, Get Promoter, and Create Promoter in FirstPromoter, plus 23 more actions.
Does connecting FirstPromoter to FlowRunner require OAuth?
No. FirstPromoter connects to FlowRunner with an API key, no OAuth flow required.
Can FirstPromoter trigger a FlowRunner workflow automatically?
Yes. FirstPromoter supports 1 trigger that can start a FlowRunner workflow automatically.
Start building with FirstPromoter
$100 in credits. No card required. Connect in minutes.