customer.created

Sent when a customer is created in Cooledge. Delivered to your webhook subscriptions. Deliveries are at-least-once, so dedupe on X-Cooledge-Event-Id.

Envelope

Every event shares the flat envelope: event_type, version ("v1"), event_id, business_id, occurred_at, plus the fields below. See the events overview for the envelope detail and webhooks for signature verification and delivery semantics.

Fields

Field	Type	Notes
`customer_id`	string	UUID of the new customer.
`name`	string or null	The customer's display name as saved on the row.
`legal_name`	string or null	The customer's legal or trading name, when set.
`email`	string or null	The customer's default email.
`phone`	string or null	The customer's default phone.
`external_simpro_customer_id`	string or null	The customer's id in Simpro, if you set one. Null otherwise.
`external_ghl_contact_id`	string or null	The matching GoHighLevel contact id. Agencies match customer events on this field. Often null for customers created through the API.
`external_ghl_opportunity_id`	string or null	The matching GoHighLevel opportunity id, when one is linked. Usually null for a plain customer.
`customer_name`	string or null	The customer's name re-read for correlation. Usually mirrors `name`.
`customer_email`	string or null	The customer's email re-read for correlation. Usually mirrors `email`.
`customer_phone`	string or null	The customer's phone re-read for correlation. Usually mirrors `phone`.

The customer_name, customer_email and customer_phone fields come from a correlation re-read of the same row, so they normally match name, email and phone. The external_ghl_* fields are correlation ids that agencies match on and are often null for customers created through the API.

Example

{
  "version": "v1",
  "event_type": "customer.created",
  "event_id": "8f2d6b41-9c30-4e7a-a15b-6d0e3c9f2a87",
  "business_id": "a7f3c9d1-2e84-4b6f-8c01-5d9e2a1f7b30",
  "occurred_at": "2026-06-17T03:21:00.000Z",
  "customer_id": "9d2e7c41-6b08-4a3f-bf52-1e0c4d8a9f63",
  "name": "Marcus Webb",
  "legal_name": "Webb Plumbing Pty Ltd",
  "email": "marcus@webbplumbing.com.au",
  "phone": "+61412345678",
  "external_simpro_customer_id": null,
  "external_ghl_contact_id": null,
  "external_ghl_opportunity_id": null,
  "customer_name": "Marcus Webb",
  "customer_email": "marcus@webbplumbing.com.au",
  "customer_phone": "+61412345678"
}

See webhooks for signature verification and delivery semantics, and all events.

Webhook event: customer.created

customer.created

Envelope

Fields

Example