Events/Customers
customer.createdBuyer-initiated

Customer 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": "4da3c993-3dc9-49de-84ce-e2658e8390a9",
  "event": "customer.created",
  "created": "2026-06-12T02:18:48.262Z",
  "data": {
    "id": "cnvnmh1upbbm0000000000000",
    "email": "chinedu.adebayo42@yahoo.com",
    "name": "Chinedu Adebayo",
    "phone": "+2349078497601",
    "firstOrderId": "c2za6haocsry0000000000000",
    "firstOrderNumber": "TY-ASA4M6Z"
  }
}

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.