Skip to main content
Dub

commission.created

2 min read

Occurs whenever a commission is created for a partner (clawbacks will also trigger this event with a negative amount).

Tip

When enabled, this webhook is triggered when a commission is created either from a tracked conversion or manually in the dashboard.

Use the userId field to distinguish between manual commissions from automatic ones.

Response body parameters

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

idstring#
The event ID.
eventstring#
The event type that triggered the webhook (e.g., commission.created).
createdAtstring#
ISO 8601 timestamp when the webhook event was created.
dataobject#
Event-specific data containing detailed information about the event. The data object for the commission.created event contains the following parameters:
Show object parameters
idstring#

Unique identifier for the commission.

typestring#

Commission type (e.g. sale).

amountnumber#

Sale/order amount in cents.

earningsnumber#

Commission earnings in cents.

currencystring#

Currency code (e.g. usd).

statusstring#

Commission status (e.g. pending).

invoiceIdstring | null#

Related invoice ID, if any.

descriptionstring | null#

Optional description (e.g. for manual commissions).

quantitynumber#

Quantity (e.g. number of items).

userIdstring | null#

ID of the user who created the commission. Set for manual commissions; null for automatic.

createdAtstring#

ISO 8601 timestamp when the commission was created.

updatedAtstring#

ISO 8601 timestamp when the commission was last updated.

partnerobject#

The partner that earned the commission (id, name, email, image, country, groupId, totalClicks, totalLeads, totalSales, totalSaleAmount, totalCommissions).

customerobject | null#

The customer associated with the conversion. Null for click-based or custom commissions.

Show customer object
idstring#

Unique identifier for the customer.

externalIdstring#

Your external customer ID, if provided when tracking.

namestring#

Customer name.

emailstring#

Customer email address.

avatarstring | null#

URL to the customer's avatar.

countrystring#

Country code.

salesnumber#

Number of sales from this customer.

saleAmountnumber#

Total sale amount in cents.

createdAtstring#

ISO 8601 timestamp when the customer was first seen.