Dub Webhooks

Webhooks send real-time notifications when events happen in your Dub workspace. All webhook payloads follow this structure:

webhook-payload.json

{
  "id": "evt_KleiO4HBwZFbO1vZLWIPZ2AtX",
  "event": "link.created",
  "createdAt": "2024-08-26T16:41:52.346Z",
  "data": {}
}

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).
`program_application.created`	Occurs whenever a partner applies to your program (directly, or by completing their application after signup).
`partner.application_submitted`	Deprecated. Use `program_application.created` instead. 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).
`bounty.created`	Occurs whenever a bounty is created in your program.
`bounty.updated`	Occurs whenever a bounty in your program is updated.
`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.

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.