Tapfiliate

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.

22 actions available

A new order closes in another system

Agent reads the order's tracking identifier and amount

Agent records the sale with Create Conversion and its commission

Agent lists pending commissions with List Commissions

Finance channel gets the pending payout total

Agent marks a verified commission with Approve Commission

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](/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](/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

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

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

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

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.

Start building with Tapfiliate

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us