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": "2332eb7e-0267-4c92-83c4-539c38c97b32",
"event": "customer.created",
"created": "2026-10-25T18:11:03.963Z",
"data": {
"id": "cd6n3iu2dpfg0000000000000",
"email": "wale.eze10@outlook.com",
"name": "Wale Eze",
"phone": "+2349055303369",
"firstOrderId": "ch7xik4wp4kg0000000000000",
"firstOrderNumber": "TY-58WBFFK"
}
}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.