contact.deleted

Sent when a contact is deleted. Use it to remove them from your own records. data holds only the contact’s ID and number.

Called Contact deleted in the app. Part of the plan feature webhooks.contacts. To subscribe over the API, the key needs contacts:read.

PayloadPOST to your endpoint

{
  "id": "evt_aeec58dda0189a2647e81bdb0dcca6e4",
  "type": "contact.deleted",
  "api_version": "2026-10-14",
  "created_at": "2026-10-14T11:15:09.652Z",
  "workspace_id": "2b7e4c1a-9d3f-4a85-b6e2-5f0c8d1a7e34",
  "data": {
    "contact_id": "7d3b5f9a-2c4e-4b68-a1d0-8e6c4a2f0b97",
    "phone": "+919812345678"
  }
}

Headers

webhook-id: The delivery’s ID, the same on every try.
webhook-timestamp: When this try was sent, in Unix seconds.
webhook-signature: v1, and an HMAC-SHA256 of the request.

How delivery and retries work

Data

What’s in data. Every event wraps it in the same envelope.

contact_id string · uuid

phone string · nullable

The number the contact had, or null if it had none.

Handling it

Answer with any 2xx within 10 seconds. Do the work after.
Check the signature first. Verify webhooks has the code.
Subscribe with POST /v1/webhooks, events: ["contact.deleted"].