Dub

Approve a bounty submission. Optionally specify a custom reward amount.

Approve a pending partner application to your program. The partner will be enrolled in the specified group and notified of the approval.

Ban a partner from your program. This will disable all links and mark all commissions as canceled.

Bulk create up to 100 links for the authenticated workspace.

Bulk delete up to 100 links for the authenticated workspace.

Bulk update up to 100 commissions with the same status.

Bulk update up to 100 links with the same data for the authenticated workspace.

Check if a domain name is available for purchase. You can check multiple domains at once.

Create one or more commissions (custom, lead or sale) for a partner. Commission creation is processed asynchronously. Use the List Commissions endpoint or webhooks to be notified when the commission is created.

Create a domain for the authenticated workspace.

Create a folder for the authenticated workspace.

Create a link for the authenticated workspace.

Creates or updates a partner record (upsert behavior). If a partner with the same email already exists, their program enrollment will be updated with the provided tenantId. If no existing partner is found, a new partner will be created using the supplied information.

Create a link for a partner that is enrolled in your program.

Create a referrals embed token for the given partner/tenant. The endpoint first attempts to locate an existing enrollment using the provided tenantId. If no enrollment is found, it resolves the partner by email and creates a new enrollment as needed. This results in an upsert-style flow that guarantees a valid enrollment and returns a usable embed token.

Create a tag for the authenticated workspace.

This will deactivate the partner from your program and disable all their active links. Their commissions and payouts will remain intact. You can reactivate them later if needed.

Delete a customer from a workspace.

Delete a domain from a workspace. It cannot be undone. This will also delete all the links associated with the domain.

Delete a folder from the workspace. All existing links will still work, but they will no longer be associated with this folder.

Delete a link for the authenticated workspace.

Delete a tag from the workspace. All existing links will still work, but they will no longer be associated with this tag.

Retrieve a customer by ID for the authenticated workspace. To retrieve a customer by external ID, prefix the ID with `ext_`.

Retrieve a paginated list of customers for the authenticated workspace.

Retrieve the info for a link.

Retrieve a paginated list of links for the authenticated workspace.

Retrieve the number of links for the authenticated workspace.

Retrieve a QR code for a link.

Retrieve a paginated list of tags for the authenticated workspace.

List all submissions for a specific bounty in your partner program.

Retrieve a paginated list of commissions for your partner program.

Retrieve a paginated list of domains for the authenticated workspace.

Retrieve a paginated list of events for the authenticated workspace.

Retrieve a paginated list of folders for the authenticated workspace.

Retrieve a paginated list of pending applications for your partner program.

List all partners for a partner program.

Retrieve a paginated list of payouts for your partner program.

Register a domain for the authenticated workspace. Only available for Enterprise Plans.

Reject a bounty submission with a specified reason and optional note.

Reject a pending partner application to your program. The partner will be notified via email that their application was not approved.

Retrieve analytics for a link, a domain, or the authenticated workspace. The response type depends on the `event` and `type` query parameters.

Retrieve analytics for a partner within a program. The response type vary based on the `groupBy` query parameter.

Retrieve a partner's links by their partner ID or tenant ID.

Track a lead for a short link.

This endpoint is used to track when a user opens your app via a Dub-powered deep link (for both iOS and Android).

Track a sale for a short link.

Update an existing commission amount. This is useful for handling refunds (partial or full) or fraudulent sales.

Update a customer for the authenticated workspace.

Update a domain for the authenticated workspace.

Update a folder in the workspace.

Update a link for the authenticated workspace. If there's no change, returns it as it is.

Update a tag in the workspace.

Upsert a link for the authenticated workspace by its URL. If a link with the same URL already exists, return it (or update it if there are any changes). Otherwise, a new link will be created.

Upsert a link for a partner that is enrolled in your program. If a link with the same URL already exists, return it (or update it if there are any changes). Otherwise, a new link will be created.