Introduction

Use postbacks to get real-time notifications on events happening across your Dub partner account.

Postbacks are currently in private beta and are only available for select partners. Contact us to get access.

Postbacks allow you to listen to real-time events happening across your Dub partner account. With postbacks, you can build custom integrations with Dub, such as:

• Syncing leads to your CRM when someone signs up through your referral link
• Updating your internal dashboards when commissions are created
• Building custom attribution tools that react to lead, sale, and commission events in real time

In this guide, we’ll show you how to configure postbacks for your partner account and a list of available events you can listen to.

Creating a postback

To create a postback for your partner account, you’ll need to follow these steps:

Navigate to the Postbacks page in your Dub partner profile.

Click on Add Postback to create a new postback.

Fill in the required fields in the postback creation form:

1. Name: Give your postback a name that helps you identify it.
2. URL: Enter the URL of the endpoint where you want to send the postback. We recommend using webhook.site to test your postback.
3. Triggers: Select the events you want to listen to. You can select multiple events. Refer to the Event Types section to see the list of available events.

Finally, click on Create postback to create the postback. After creation, you’ll see your signing secret — make sure to copy and store it securely.

Viewing postback event logs

We also provide you with a postback event logs page where you can view all the postback events that have been sent to your endpoint in real-time.

To view the postback event logs, select the postback from the Postbacks page and click on the postback to open its details page.

Here, you’ll see a list of all the postback events that have been sent to your endpoint:

You can also select a specific event, which will open up a sheet with more details about the event.

Sending test events

You can send test events to your postback URL to ensure that it’s working correctly. To do this:

1. Go to the postback details page

   Navigate to the Postbacks page and select the postback you want to test.

   Click on the postback to open the postback details page.

2. Open the test event modal

   Select the ⋮ icon on the top right of the page, and click on Send test event.

   This will open up a modal where you can select the event you want to send.

   
3. Send the test event

   Select the event you want to send, and click on Send test postback.

   

   You’ll see a success message and receive the postback event in the endpoint you specified.

Secret rotation

If you need to rotate your postback signing secret (for example, after a suspected compromise), select the ⋮ icon on the postback details page and click on Rotate secret. A new secret will be generated.

Retry Behaviour

If your postback endpoint does not respond with a success status code (2XX), we retry the request to ensure every message will be delivered. You can see all the retry attempts in your postback event logs.

Postbacks are retried until they are successfully delivered – with an exponential backoff to avoid overwhelming your postback endpoint (also known as the “thundering herd problem”). The delay is capped at 24 hours from the 5th retry attempt onwards.

Retry attempt	Delay
1st	12s
2nd	2m 28s
3rd	30m 8s
4th	6h 7m 6s
5th	24h
6th	24h
…	…