{ "opencollection": "1.0.0", "info": { "name": "FirstPromoter Tracking API V2", "version": "1.0.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "POST /signup", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/track/signup", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Capture a lead when they sign-up or fill an optin form. This endpoint is used to track leads and sign-ups. It's not for tracking the actual sales and commissions.

Sign-ups are tracked as leads in FirstPromoter so when a person referred by the promoter/affiliate signs up, a new referral should be added inside FirstPromoter **(you can see them inside the `Referrals` section as `Leads`)**.

The recommended way to do this is to grab the `_fprom_tid` **(_fprom_track for acc" }, { "info": { "name": "POST /sale", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/track/sale", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Assign sales and commissions to your promoters. To track sales and generate commissions correctly, you need to use this API call each time a non-zero amount sale is processed in your system, even if it comes from a recurring charge or one-time charge. To avoid fraudulent sales, we don't use JS conversion pixels to track sales, which are very unreliable and can be easily faked. Instead, we use server-side tracking for all sales to ensure that a sale is tracked only when you actually receive" }, { "info": { "name": "POST /refund", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/track/refund", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "The refund call is similar to the sale call. It works the same way, except that it generates negative commissions. **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/track/refund`
" }, { "info": { "name": "POST /cancellation", "type": "http" }, "http": { "method": "POST", "url": "https://api.firstpromoter.com/api/v2/track/cancellation", "headers": [ { "name": "Account-ID", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "This call will mark the customer as cancelled and will decrease the MRR generated by them. **HTTP Request**
`POST https://api.firstpromoter.com/api/v2/track/cancellation`
" } ], "bundled": true }