--- title: "Tapfiliate Integration" description: "Connect AI agents to Tapfiliate. Agents enroll and approve affiliates, add them to programs, record conversions and commissions, manage approval status, and attribute customers for referral tracking." url: https://flowrunner.ai/integrations/tapfiliate date_modified: 2026-08-07T17:20:23-07:00 --- # Tapfiliate [Advertising](https://flowrunner.ai/integrations/category/marketing-social) Connect AI agents to Tapfiliate. Agents enroll and approve affiliates, add them to programs, record conversions and commissions, manage approval status, and attribute customers for referral tracking. [Verified](https://flowrunner.ai/integrations/verified "What does verified mean?") · 22 actions · API key · available [Tapfiliate website](https://tapfiliate.com/) · [Platform Documentation](https://tapfiliate.com/docs/rest/) · Capability data verified 2026-07-14 1. A new order closes in another system 2. Agent reads the order's tracking identifier and amount 3. Agent records the sale with Create Conversion and its commission 4. Agent lists pending commissions with List Commissions 5. Finance channel gets the pending payout total 6. Agent marks a verified commission with Approve Commission 7. Commission approval routes to finance before it becomes payable ## What This Integration Enables An agent can create, read, list, update, and delete affiliates, and approve or disapprove an affiliate per program. It lists and reads programs, adds an affiliate to a program (approved immediately or not, with an optional coupon), and lists a program's affiliates. This is the enrollment side: bring an affiliate in, place them in the right program, and set their approval. For attribution and payout, the agent records a conversion with at least one tracking identifier (click id, referral code, customer id, or coupon), an order amount for automatic commission calculation, and metadata, then reads and lists conversions. It adds a commission to a conversion, lists and reads commissions filtered by payout status, and approves or disapproves a commission (the step that moves it into or out of the payable balance). It also creates and reads customers for customer-based recurring tracking. Tapfiliate exposes no event triggers in this integration, so flows start from the systems feeding it: a store, a checkout, or a payout run. The agent is the bridge between where sales happen and the affiliate program that credits them. ### Without FlowRunner **Conversions logged by hand**: Someone matches orders to affiliates and enters conversions manually **Attribution missed**: A referred sale is never credited because no one recorded it **Payouts approved loosely**: Commissions become payable with no consistent review step ### With FlowRunner **Conversions logged on the order**: Create Conversion records the sale and its commission as the order closes **Attribution captured**: The tracking identifier ties each sale to the referring affiliate **Payouts reviewed**: Approve Commission runs only after a human signs off on the payout ## Use Case Scenarios ### Record a Referred Sale When a store fires a new-order event, the agent calls Create Conversion to record the sale and generate the referring affiliate's commission. The referral is credited the moment the order closes, with the tracking identifier tying it to the right affiliate. ### Attribute a Recurring Customer Alongside a new order, the agent calls Create Customer to attribute each new buyer to their affiliate for recurring, customer-based commission tracking. Future purchases by that customer keep crediting the affiliate who referred them. ### Reconcile a Refund After the agent runs Approve Commission on a verified payout, a later refund in [Stripe](https://flowrunner.ai/integrations/stripe) can trigger a reconcile flow that calls Disapprove Commission to remove the commission from the payable balance. The affiliate ledger stays honest when an order is reversed. ## Human-in-Loop Highlight Approving a commission moves it into the payable balance, which is the moment money becomes owed to an affiliate. A wrongly approved commission on a fraudulent or reversed order is real money out the door. So the agent records conversions and commissions automatically, but treats Approve Commission as a [human-in-the-loop](https://flowrunner.ai/concepts/human-in-the-loop) step. It pauses, shows finance the affiliate, the conversion it stems from, the amount, and the order behind it, and asks for sign-off through Slack or email. Finance approves, and the agent approves the commission. Finance holds, and it stays pending, or gets disapproved. The AI keeps the affiliate ledger current; the call that makes a payout owed gets a human. Agent processes routinely Detects exception requiring judgment Clear match Continues automatically Ambiguous Routes to human via Slack Human decides Agent resumes with decision ## Agent Capabilities 22 actions ### Affiliates 7 - **Create Affiliate** Creates a new affiliate account (firstname, lastname, email required), optionally with a password, company object, and profile fields. Returns the affiliate with its generated id and referral code. - **Get Affiliate** Retrieves a single affiliate by id, including profile, referral link, company, and approval status. - **List Affiliates** Lists affiliates, optionally filtered by click id, source id, or referral code, paginated. - **Update Affiliate** Updates an affiliate's profile fields. Only provided fields change. - **Delete Affiliate** Permanently deletes an affiliate by id. This cannot be undone. - **Approve Affiliate** Approves an affiliate's participation in a specific program. Approval is per program. - **Disapprove Affiliate** Revokes an affiliate's approval in a specific program. ### Programs 4 - **List Programs** Lists all affiliate programs with their id, title, currency, and commission structure, paginated. - **Get Program** Retrieves a single program by id, including its commission settings and asset details. - **Add Affiliate to Program** Adds an existing affiliate to a program, identified by id or email, optionally approved immediately and assigned a coupon. - **List Program Affiliates** Lists the affiliates enrolled in a program, optionally filtered by approval status. ### Conversions and Commissions 8 - **Create Conversion** Records a conversion (sale or lead) and its commissions, attributed by a tracking identifier, with an optional amount, external id, manual commissions, and metadata. - **Get Conversion** Retrieves a single conversion by id, including its amount, attributed affiliate, and commissions. - **List Conversions** Lists conversions, optionally filtered by program, affiliate, external id, or date range, paginated. - **Add Commission to Conversion** Adds an additional commission to an existing conversion, calculated from a provided sub-amount. - **List Commissions** Lists commissions, optionally filtered by payout status (pending, approved, disapproved, paid), affiliate, or conversion. - **Get Commission** Retrieves a single commission by id, including amount, approval status, affiliate, and parent conversion. - **Approve Commission** Approves a pending commission, making it eligible for payout. - **Disapprove Commission** Disapproves a commission, removing it from the payable balance. ### Customers 3 - **Create Customer** Creates a customer record attributed to an affiliate for customer-based recurring tracking, attributed by click id or referral code. - **Get Customer** Retrieves a single customer by id, including the attributed affiliate and status. - **List Customers** Lists customers, optionally filtered by attributed affiliate, program, or date range, paginated. ## Frequently Asked Questions ### What can FlowRunner do with Tapfiliate? FlowRunner agents can run Create Affiliate, Get Affiliate, and List Affiliates in Tapfiliate, plus 19 more actions. ### Does connecting Tapfiliate to FlowRunner require OAuth? No. Tapfiliate connects to FlowRunner with an API key, no OAuth flow required. ### Can Tapfiliate trigger a FlowRunner workflow automatically? Tapfiliate doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger. **Work at Tapfiliate?** This integration exposes Tapfiliate to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current. --- Markdown version of https://flowrunner.ai/integrations/tapfiliate. Site index: https://flowrunner.ai/llms.txt