{
"type": "contact.deleted",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2026-10-21T10:15:00Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"origin": "api",
"contact": {
"object": "contact",
"id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z",
"email": "someone@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"status": "enabled",
"status_reason": "",
"unsubscribed": false,
"unsubscribed_at": null,
"attributes": {
"plan": "pro"
},
"validation_status": "valid",
"last_validated_at": "2026-10-20T10:15:00Z"
}
}
}Contact Events
contact.deleted Webhook Event
The contact.deleted webhook fires when an AhaSend contact is deleted, with its list memberships. The payload holds the contact as it was before the delete.
WEBHOOK
contact.deleted
{
"type": "contact.deleted",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2026-10-21T10:15:00Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"origin": "api",
"contact": {
"object": "contact",
"id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z",
"email": "someone@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"status": "enabled",
"status_reason": "",
"unsubscribed": false,
"unsubscribed_at": null,
"attributes": {
"plan": "pro"
},
"validation_status": "valid",
"last_validated_at": "2026-10-20T10:15:00Z"
}
}
}AhaSend sends this event when a contact is deleted.
data.contact is the contact as it was right before the delete. The contact’s list memberships are deleted with it, and they send no contact.removed_from_list.
Setting: on_contact_deleted (Contact Deleted in the dashboard).
Requirements:
- Your account has the marketing features. Contact events cannot be turned on without them.
- A webhook with this event on needs an API key with
contacts:readwhen you create or update it through the API. See contact events.
Related Guides
- API authentication, Permission scopes, Webhook setup.
- Event reference, Webhook CLI, Local webhook testing.
- Signature verification, Retry policy, API errors.
- API rate limits, Contacts API, Lists API.
Body
application/json
The event type
Available options:
contact.deleted The webhook ID (the same ID as returned by the Create Webhook API)
When the change happened (ISO 8601 format)
Show child attributes
Show child attributes
Response
Webhook received successfully