Postbacks let partners receive a request at their own URL whenever one of their customers or commissions is created, updated or deleted. Partners use them to sync data to their backend or other tools.
Postbacks are in beta.
Turn on postbacks
Go to Program settings › Tracking & safeguards.
Under Partner tools, switch on Enable postbacks.
Your partners can now set up postbacks in their partner portal.
How partners set up a postback
In the partner portal, go to Settings › Postbacks.
Create a postback with a name, the endpoint URL and the event types to send.
Open the postback and click Test URL to check the endpoint.
Each postback has Postback logs. Open a log to see the request payload and the response data.
Event types
Event | Sent when |
| A customer the partner referred is created, updated or deleted. |
| One of the partner's commissions is created, updated or deleted. |
Payload format
Every postback sends a JSON payload. This is a commission event:
{
"data": {
"id": "comm_1234567890",
"type": "reward",
"amount": "5000",
"status": "pending",
"payout_id": null,
"created_at": "2025-09-26T14:26:58.524Z",
"partner_id": "part_1234567890",
"program_id": "prg_1234567890",
"updated_at": "2025-09-26T14:27:04.220Z",
"customer_id": "cus_1234567890",
"approval_type": "manual"
},
"type": "commission.created",
"timestamp": "2025-09-26T14:27:08.226Z"
}
Customer events also include a params object with the parameters of the partner link the customer came through. This JSON payload is for a customer who came through https://example.com?utm_source=test:
{
"data": {
"id": "cus_1234567890",
"name": "Jane Doe",
"email": "[email protected]",
"status": "lead",
"created_at": "2025-10-02T13:39:47.661Z",
"identifier": "Jane Doe",
"partner_id": "part_1234567890",
"program_id": "prg_1234567890",
"updated_at": "2025-10-02T13:39:56.676Z"
},
"type": "referral.created",
"params": {
"utm_source": "test"
},
"timestamp": "2025-10-02T13:51:33.691Z"
}
Failed deliveries
Tolt sends postbacks in the background. If the endpoint doesn't respond, Tolt retries after 1 minute, then 2 more times, 5 minutes apart. Retries stop if the partner deletes the postback or you turn off postbacks.