customer.created

{ "event": "customer.created", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "id": "cus_1a2b3c4d", "externalId": "user_123", "fullName": "Ada Lovelace", "email": "ada@acme.com", "taxDocument": "20-12345678-9", "documentType": "CUIT", "businessTaxId": null, "timezone": "UTC", "metadata": { "plan_intent": "pro" }, "createdAt": "2026-03-25T14:29:00.000Z", "updatedAt": "2026-03-25T14:29:00.000Z" } }

Resource shape and version pinning

The payload is the customer resource exactly as the REST API returns it for your pinned API version. If your endpoint is pinned to a version before 2026-06-07, the email field arrives as billingEmail — the same downgrade applied to GET /customers responses.

The event fires for every creation path: POST /customers, batch create, the SDKs, and the dashboard. Creating a customer with an externalId that already exists returns the existing customer and does NOT fire this event again.

Body

application/json

string

required

event

string

required

Allowed value: "customer.created"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

customer.created

Resource shape and version pinning

Body

Response

​Resource shape and version pinning

Body

Response

Resource shape and version pinning