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.

taxDocumentstring | null

The customer's tax identification number, if provided.

documentTypestring | null

The local tax document type label inferred from the customer's country (e.g. CUIT, RFC, RUT), or null when no tax document was provided.

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-06-23T14:30:00.000Z",
  "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
  "mode": "live",
  "apiVersion": "2026-07-11",
  "data": {
    "id": "cus_1a2b3c4d",
    "externalId": "user_123",
    "fullName": "Ada Lovelace",
    "email": "ada@acme.com",
    "taxDocument": "20-12345678-9",
    "documentType": "CUIT",
    "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.