customer.createdBuyer-initiatedCustomer created
A new Customer row was created (first purchase from a buyer). Use this to sync to your CRM.
When this fires
A new customer record was created — usually the moment their first order checks out.
High frequency
This event is buyer-initiated, which means it can fire at checkout-traffic volume during busy periods. Make sure your handler responds in under ten seconds; queue any heavy work.
Sample payload
This is the exact envelope shape we POST to your endpoint — outer wrapper plus the per-event data payload. Field values are randomised on each render so you see the general shape, not a fixed example.
json
{
"id": "4ae7854c-c90b-4969-89d8-3de0f866bbeb",
"event": "customer.created",
"created": "2026-06-12T15:00:35.832Z",
"data": {
"id": "cf387ibnqie00000000000000",
"email": "seyi.balogun5@gmail.com",
"name": "Seyi Balogun",
"phone": "+2347013531268",
"firstOrderId": "c49xxbyt71la0000000000000",
"firstOrderNumber": "TY-1ZYBC8A"
}
}Use cases
- Sync the new contact into your CRM (HubSpot, Klaviyo, Mailchimp).
- Send a welcome email or first-time-buyer discount.
- Tag the source channel for attribution reporting.
Subscribe in the dashboard
To start receiving this event, add it to a webhook's subscription list in Developers → Webhooks. Wildcard subscriptions ( customer.*) work too — see the webhooks guide for the matching rules.