{
"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
}