Webhooks send real-time notifications when events happen in your Dub workspace. All webhook payloads follow this structure:
webhook-payload.json
- id – Unique event ID
- event – Event type (e.g.
link.created) - createdAt – ISO 8601 timestamp when the event was created
- data – Event-specific payload
Dub Partners#
Here are the webhook events that are available for Dub Partners:
| Event Type | Description |
|---|---|
partner.enrolled | Occurs whenever a partner is enrolled in your program (either their application was approved, they accepted your invite, or via the API). |
partner.application_submitted | Occurs whenever a partner submits an application to your program. |
partner.merged | Occurs when two partner accounts are merged. |
lead.created | Occurs whenever a lead is created. |
sale.created | Occurs whenever a sale is created. |
commission.created | Occurs whenever a commission is created for a partner (clawbacks will also trigger this event with a negative amount). |
discount_code.created | Occurs whenever a discount code is created for a partner. |
discount_code.deleted | Occurs whenever a discount code for a partner is deleted. |
Dub Links#
Here are the webhook events that are available for Dub Links:
| Event Type | Description |
|---|---|
link.created | Occurs whenever a link is created. |
link.updated | Occurs whenever a link is updated. |
link.deleted | Occurs whenever a link is deleted. |
link.clicked | Occurs whenever a link is clicked. |