Postback URLs let you send conversion data from FirstPromoter to a third-party service whenever a key event occurs in your affiliate program. They give your affiliates a way to pass 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 (a new referral, a new customer, or a new commission), FirstPromoter sends an HTTP request to the URL you configure. That request includes dynamic variables — such as a click ID or commission amount — that get substituted with real values at the time of the event.
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.
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.
