> ## Documentation Index
> Fetch the complete documentation index at: https://dub.co/llms.txt
> Use this file to discover all available pages before exploring further.

# commission.created

Occurs whenever a [commission is created](/docs/api-reference/commissions/create) 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.

**id** `string`

The event ID.
**event** `string`

The event type that triggered the webhook (e.g., `commission.created`).
**createdAt** `string`

ISO 8601 timestamp when the webhook event was created.
**data** `object`

Event-specific data containing detailed information about the event. The
data object for the `commission.created` event contains the following
parameters:

**object parameters**

**id** `string`

Unique identifier for the commission.

**type** `string`

Commission type (e.g. `sale`).

**amount** `number`

Sale/order amount in cents.

**earnings** `number`

Commission earnings in cents.

**currency** `string`

Currency code (e.g. `usd`).

**status** `string`

Commission status (e.g. `pending`).

**invoiceId** `string | null`

Related invoice ID, if any.

**description** `string | null`

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

**quantity** `number`

Quantity (e.g. number of items).

**userId** `string | null`

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

**metadata** `object | null`

Metadata from the associated lead or sale event, or from Stripe webhook metadata.

**createdAt** `string`

ISO 8601 timestamp when the commission was created.

**updatedAt** `string`

ISO 8601 timestamp when the commission was last updated.

**partner** `object`

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

**customer** `object | null`

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

**customer object**

**id** `string`

Unique identifier for the customer.

**externalId** `string`

Your external customer ID, if provided when tracking.

**name** `string`

Customer name.

**email** `string | null`

Customer email address.

**avatar** `string | null`

URL to the customer's avatar.

**stripeCustomerId** `string | null`

The customer's Stripe customer ID, if linked.

**country** `string`

Country code.

**sales** `number`

Number of sales from this customer.

**saleAmount** `number`

Total sale amount in cents.

**createdAt** `string`

ISO 8601 timestamp when the customer was first seen.

**firstSaleAt** `string | null`

ISO 8601 timestamp of the customer's first sale.

**subscriptionCanceledAt** `string | null`

ISO 8601 timestamp when the customer's subscription was canceled.

**link** `object | null`

The referral link associated with the commission.

**link object**

**id** `string`

Link ID.

**shortLink** `string`

Full short link URL.

**domain** `string`

Short link domain.

**key** `string`

Short link path/slug.

```json Response theme={null}
{
  "id": "evt_64dv6vxYVgltzJBKc9ujJ1ghL",
  "event": "commission.created",
  "createdAt": "2025-07-16T10:48:15.468Z",
  "data": {
    "id": "cm_1K09DJTBCRT24P6BRD515CK29",
    "type": "sale",
    "amount": 50000,
    "earnings": 10000,
    "currency": "usd",
    "status": "pending",
    "invoiceId": null,
    "description": null,
    "quantity": 1,
    "userId": "cludszk1h0000wmd2e0ea2b0p",
    "metadata": null,
    "createdAt": "2025-07-16T10:48:14.722Z",
    "updatedAt": "2025-07-16T10:48:14.960Z",
    "partner": {
      "id": "pn_1K06X6FX2GRB31NCM2VVCGJ72",
      "name": "Matthew Hayden",
      "email": "matthew@example.com",
      "image": null,
      "payoutsEnabledAt": null,
      "country": "US",
      "groupId": "grp_1K6K3HD0QE7XTX5HSVR77AK5B",
      "totalClicks": 50,
      "totalLeads": 15,
      "totalConversions": 10,
      "totalSales": 10,
      "totalSaleAmount": 100000,
      "totalCommissions": 50000
    },
    "customer": {
      "id": "cus_1K09DJDEACR47NPYC93RM43WF",
      "externalId": "TaMD05AnuyqeI",
      "name": "David",
      "email": "david@example.com",
      "avatar": null,
      "stripeCustomerId": null,
      "country": "US",
      "sales": 1,
      "saleAmount": 50000,
      "createdAt": "2025-07-16T10:48:01.739Z",
      "firstSaleAt": null,
      "subscriptionCanceledAt": null
    },
    "link": {
      "id": "cm0lcuvtz000xcutmqw4a7wi3",
      "shortLink": "https://dub.sh/track-test",
      "domain": "dub.sh",
      "key": "track-test"
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.