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": "e50c85e0-3417-4374-b715-097bb06d8f42",
"event": "customer.created",
"created": "2026-09-13T19:47:17.790Z",
"data": {
"id": "cgcmpnbupjg70000000000000",
"email": "ngozi.nwosu64@yahoo.com",
"name": "Ngozi Nwosu",
"phone": "+2347060276159",
"firstOrderId": "cdu6p3i73nnw0000000000000",
"firstOrderNumber": "TY-86VFIRU"
}
}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.