customer.created

{ "id": "evt_1a2b3c4d5e6f7g8h", "type": "customer.created", "created_at": "2026-04-27T12:00:00.000000+00:00", "organization_id": "acct_7KpQ2mNv4XbR9dLc", "data": { "customer_id": "cust_1a2b3c4d5e6f", "email": "jane@example.com", "name": "Jane Doe", "phone_number": "+2348012345678", "metadata": {}, "billing_address": { "line1": "40 Yaba Road", "line2": null, "city": "Lagos", "state": "Lagos", "postal_code": "101245", "country": "NG" }, "created_at": "2026-04-27T12:00:00Z", "updated_at": "2026-04-27T12:00:00Z" } }

A checkout created without a customer fires this event too, once the buyer identifies themselves on the hosted page. The one case that does not is a checkout created with customer_creation: "if_required", which creates no record and so emits nothing. See Whether a guest becomes a customer.

Event fields

string

The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.

string

Always customer.created.

string

When the event occurred, in UTC.

string

Your account’s ID.

string

The customer’s ID, prefixed cust_.

string

The customer’s email address.

string | null

The customer’s name.

string | null

The customer’s phone number in E.164 format.

object

Your own key-value data on the customer.

object | null

The customer’s billing address: line1, line2, city, state, postal_code, and country (ISO-3166-1 alpha-2). null when no address is stored.

string

When the customer was created, in UTC.

string

When the customer was last updated, in UTC.

Concepts

Events

Endpoint API

customer.created

Event fields

​Event fields

Event fields