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](/integrations/typeform) into promoters with generated referral links - Attribute signups the moment a referred user converts, before the cookie is gone - Record [Stripe](/integrations/stripe) purchases and renewals as tracked sales with commission calculation - Build monthly payout reports in [Google Sheets](/integrations/google-sheets) from commission data - Audit referral activity per promoter and campaign for reconciliation - Notify the finance team in [Slack](/integrations/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](/integrations/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](/integrations/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](/integrations/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
8 actionsPromoters
4- 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.
- 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.
Referrals
1- 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.
Commissions
1- 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.
Tracking
2- 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.
Frequently Asked Questions
What can FlowRunner do with FirstPromoter?
FlowRunner agents can run List Promoters, Get Promoter, and Create Promoter in FirstPromoter, plus 5 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?
FirstPromoter doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with FirstPromoter
$100 in credits. No card required. Connect in minutes.