Webhook event

customer.deleted

A customer's personal data was erased. data.object is {id, object, deleted}.

Type

customer.deleted

The object it carries

the customer object

Subscribe with

customer.deleted, customer.* or *

Example payload

The body of the request your endpoint receives, shown here over several lines. On the wire it is compact JSON; check its signature over the bytes exactly as they arrive.

{
  "id": "evt_82zpak5v44rfqfr4abc8r45d",
  "object": "event",
  "livemode": true,
  "created": "2026-10-11T14:09:55.764Z",
  "type": "customer.deleted",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "cus_8ea07c40qsvv19f7rgmeb8ha",
      "object": "customer",
      "deleted": true
    }
  },
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "pending_webhooks": 1
}

Fields of data.object

What each field means is on the page of the customer object. This event carries no data.previous_attributes.

Endpoints behind it

Calls that change customers. An event is also sent when a payer, the network, a timer or a person in the dashboard causes the change; the sentence above says which.

• POSTCreate a customer/v1/customers
• PATCHUpdate a customer/v1/customers/{id}
• DELETEDelete a customer/v1/customers/{id}