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": "94b56784-3994-4cae-a9d0-c1697ae978c2",
  "event": "customer.created",
  "created": "2026-10-13T20:18:57.234Z",
  "data": {
    "id": "cgky0131j5480000000000000",
    "email": "chiamaka.ajayi10@outlook.com",
    "name": "Chiamaka Ajayi",
    "phone": "+2348031719900",
    "firstOrderId": "cc1vkwtx17a00000000000000",
    "firstOrderNumber": "TY-4J51U46"
  }
}

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.