Webhook events

customer.erased

Sent the first time a merchant erases a customer. Orders and rewards keep the customer ID.

Example payload

This illustrative payload follows the current event validator. Amounts use minor units.

json

{
  "id": "00000000-0000-4000-8000-000000000001",
  "companyId": "company-example",
  "type": "customer.erased",
  "data": {
    "customerId": "customer-example",
    "erasedAt": "2026-10-11T12:00:00.000Z"
  },
  "createdAt": "2026-10-11T12:00:00.000Z"
}

Payload fields

Field	Type	Required	Details
`customerId`	string	Yes
`erasedAt`	string	Yes	date-time

Payload schema

json

{
  "type": "object",
  "properties": {
    "customerId": {
      "type": "string",
      "minLength": 1
    },
    "erasedAt": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "customerId",
    "erasedAt"
  ],
  "additionalProperties": true
}

Handle delivery

Verify the signature over the raw body before parsing JSON. Check that the body ID matches Grizzlee-Event-Id. Process each ID once, since delivery can repeat.