customer.created

{
  "type": "customer.created",
  "data": {
    "id": "cus_4RkWm8ZqT2xLb7NvYc9HdPjF",
    "customer_id": "your_internal_user_id",
    "email": "jane@example.com",
    "name": "Jane Cooper",
    "status": "lead",
    "plan": null,
    "subscription_id": null,
    "partner_id": "part_8fKq2LmZx7RtYw3nVbHc5dPj",
    "link_id": "lnk_2NwKq8ZmT4xLr7VbYc3HdPjF",
    "click_id": "clk_9TkWq3ZmR7xLb2NvYc5HdPjF",
    "lead_at": "2026-08-24T14:20:03.000Z",
    "active_at": null,
    "program_id": "prg_3hTq9WxLm2RbZk7VnYc4DsPf",
    "organization_id": "org_7YtKm3QwZ9xRb2NvHc6LdPsF",
    "created_at": "2026-08-24T14:20:03.000Z",
    "updated_at": "2026-08-24T14:20:03.000Z"
  },
  "timestamp": "2026-08-24T14:20:03.412Z"
}

{
  "type": "customer.created",
  "data": {
    "id": "cus_4RkWm8ZqT2xLb7NvYc9HdPjF",
    "customer_id": "your_internal_user_id",
    "email": "jane@example.com",
    "name": "Jane Cooper",
    "status": "lead",
    "plan": null,
    "subscription_id": null,
    "partner_id": "part_8fKq2LmZx7RtYw3nVbHc5dPj",
    "link_id": "lnk_2NwKq8ZmT4xLr7VbYc3HdPjF",
    "click_id": "clk_9TkWq3ZmR7xLb2NvYc5HdPjF",
    "lead_at": "2026-08-24T14:20:03.000Z",
    "active_at": null,
    "program_id": "prg_3hTq9WxLm2RbZk7VnYc4DsPf",
    "organization_id": "org_7YtKm3QwZ9xRb2NvHc6LdPsF",
    "created_at": "2026-08-24T14:20:03.000Z",
    "updated_at": "2026-08-24T14:20:03.000Z"
  },
  "timestamp": "2026-08-24T14:20:03.412Z"
}

A customer created through POST /v2/customers can start in another status.

Every webhook is delivered as JSON with the same envelope, customer.created carries the customer in data:

string

The event name, customer.created.

object

The customer this event is about.

Hide data

string

Unique id for the customer.

string | null

Your external user id for this customer, if set.

string | null

The customer’s email address, if captured.

string | null

The customer’s name, if known.

string | null

Current status, for example lead or active.

string | null

The plan the customer is on, if any.

string | null

Id of the associated subscription, if any.

string | null

Id of the partner who referred the customer, if attributed.

string | null

Id of the link the customer came through, if any.

string | null

Id of the click that led to this customer, if any.

string | null

ISO timestamp when the customer became a lead.

string | null

ISO timestamp when the customer became active.

string | null

Id of the program the customer belongs to, if any.

string

Id of the organization that owns the program.

string

ISO timestamp when the customer was created.

string

ISO timestamp when the customer was last updated.

string

ISO 8601 time the event was emitted.

Deliveries can carry more fields than listed here, and the example below is shortened, so ignore fields you don't use.

{
  "type": "customer.created",
  "data": {
    "id": "cus_4RkWm8ZqT2xLb7NvYc9HdPjF",
    "customer_id": "your_internal_user_id",
    "email": "jane@example.com",
    "name": "Jane Cooper",
    "status": "lead",
    "plan": null,
    "subscription_id": null,
    "partner_id": "part_8fKq2LmZx7RtYw3nVbHc5dPj",
    "link_id": "lnk_2NwKq8ZmT4xLr7VbYc3HdPjF",
    "click_id": "clk_9TkWq3ZmR7xLb2NvYc5HdPjF",
    "lead_at": "2026-08-24T14:20:03.000Z",
    "active_at": null,
    "program_id": "prg_3hTq9WxLm2RbZk7VnYc4DsPf",
    "organization_id": "org_7YtKm3QwZ9xRb2NvHc6LdPsF",
    "created_at": "2026-08-24T14:20:03.000Z",
    "updated_at": "2026-08-24T14:20:03.000Z"
  },
  "timestamp": "2026-08-24T14:20:03.412Z"
}

Getting started

Events