Postback URLs allow you to send conversion data from FirstPromoter to a third-party service whenever an important event occurs in your affiliate program.
They give your affiliates a way to send event data, such as a new sign-up or commission, directly to their own tracking tools.
*Please note: This feature is only available on the Enterprise plans.
How postbacks work
When a tracked event occurs in FirstPromoter, such as a new referral, customer, or commission, FirstPromoter sends an HTTP request to the URL you configure.
The request can include dynamic variables such as a click ID, commission amount, referral ID, or other event details. These variables are automatically replaced with the actual values when the event occurs.
Available events
New referral
Triggered when a user signs up or registers using an affiliate link. This event does not include any transaction data.
Variable | Description |
| The click ID passed via |
Please note:
To pass the click_id or the {{visitor.sub_id}} correctly, the affiliate's referral link that is shared to prospective customers must include fp_sid as a query parameter set to their click ID.
For example, if the referral link is https://testdomain.com?fpr=mywebsite and the click ID is clk-id-12test, the link used for referrals should be: https://testdomain.com?fpr=mywebsite&fp_sid=clk-id-12test
This clk-id-12test is what will be captured and passed in the postback URL once it's triggered.
As an affiliate, if you want a way to generate links with different sub IDs or click IDs in this case, you can create a "New link" from the promoter dashboard and assign a sub ID there (like "blog," "facebook," etc.) as shown here.
Also for the fp_sid to be passed correctly when using the API. it is important that you track your referrals using the tid instead of the ref_id
New Customer
Triggered when a referral makes their first payment.
Variable | Description |
| The click ID passed via |
New Commission
Variable | Description |
| The click ID passed via |
| Unique ID of the event |
| Type of event |
| The conversion amount (in dollars) |
| The commission/reward amount (in dollars) |
How to add postback URLs
Postback URLs can be added by both admins and affiliates.
As an admin:
Go to the Promoters page.
Select the promoter you want to configure.
Click on Postbacks.
Click New Postback and enter the URL.
As an affiliate
Click your profile icon in the top-right corner.
Select Postbacks.
Click Create Postback and enter the URL.
Testing
Once a postback URL is configured, you can test it by clicking the Test Postback button.
Please note:
If your endpoint expects a click ID to be present before processing the postback, you will need to enter a static click ID for the test to work correctly.
