Se dispara cuando se crea un cliente. El payload refleja el recurso de cliente de GET /customers.

Payload

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

idstring

The Commet customer ID (cus_...).

externalIdstring | null

Your own identifier for this customer, if you provided one.

fullNamestring | null

The customer's full name.

emailstring

The customer's email.

timezonestring | null

The customer's timezone.

metadataobject | null

Custom key-value metadata you attached to the customer.

createdAtstring

ISO 8601 datetime when the customer was created.

updatedAtstring

ISO 8601 datetime of the last update.

{
  "event": "customer.created",
  "timestamp": "2026-03-25T14:29:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-05-25",
  "data": {
    "id": "cus_1a2b3c4d",
    "externalId": "user_123",
    "fullName": "Ada Lovelace",
    "email": "ada@acme.com",
    "timezone": "UTC",
    "metadata": {
      "plan_intent": "pro"
    },
    "createdAt": "2026-03-25T14:29:00.000Z",
    "updatedAt": "2026-03-25T14:29:00.000Z"
  }
}

Forma del recurso y fijación de versión

El payload es el recurso de cliente exactamente como lo devuelve la API REST para tu versión de API fijada. Si tu endpoint está fijado a una versión anterior a 2026-06-07, el campo email llega como billingEmail — la misma conversión que se aplica a las respuestas de GET /customers.

El evento se dispara para cada vía de creación: POST /customers, creación por lotes, los SDKs y el dashboard. Crear un cliente con un externalId que ya existe devuelve el cliente existente y NO vuelve a disparar este evento.