Customer

Customer lifecycle events and their signed payload contract.

Scope overview

This page lists every Customer event available to workspace webhooks. Use the exact event name in your receiver; the same activity is also recorded in Logs. Each row identifies the affected record.

Event list

ActionEvent nameRecord ID
Created<customer_id>
Updated<customer_id>
Deleted<customer_id>

Event payload

Every selectable event uses the same JSON Schema 1.0 payload. Only type and data.id vary by event. The payload identifies the event and affected record; it does not include a record snapshot. Fetch more detail through the relevant API when available.

Code json
{
	"id": "<event_id>",
	"type": "customer.created",
	"created": "2026-09-23T10:30:00.000Z",
	"data": {
		"id": "<customer_id>",
		"workspaceId": "<workspace_id>"
	}
}

Data fields

FieldTypeMeaning
idstringStable event ID; also sent in the webhook-id header.
typestringExact event name from the catalog.
createdstringEvent time in ISO 8601 UTC format.
data.idstringPublic ID of the affected record.
data.workspaceIdstringPublic ID of the workspace that owns the event.