{
"type": "contact.removed_from_list",
"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"
},
"list": {
"id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"name": "Newsletter"
},
"list_contact": {
"object": "list_contact",
"list_id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"contact_id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"email": "someone@example.com",
"subscription_status": "confirmed",
"subscribed_at": "2026-09-21T10:15:00Z",
"unsubscribed_at": null,
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z"
}
}
}Contact Events
contact.removed_from_list Webhook Event
The contact.removed_from_list webhook fires when an AhaSend contact is removed from a list. Deleting the contact or the list sends no event. Payload.
WEBHOOK
contact.removed_from_list
{
"type": "contact.removed_from_list",
"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"
},
"list": {
"id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"name": "Newsletter"
},
"list_contact": {
"object": "list_contact",
"list_id": "8b5a3112-8fa1-4bde-9c20-8af76484daf4",
"contact_id": "e43e4167-f186-4a7f-9b6e-ac9fdc6426e1",
"email": "someone@example.com",
"subscription_status": "confirmed",
"subscribed_at": "2026-09-21T10:15:00Z",
"unsubscribed_at": null,
"created_at": "2026-09-21T10:15:00Z",
"updated_at": "2026-10-21T10:15:00Z"
}
}
}AhaSend sends this event when a contact is removed from a list.
data.list is the list. data.list_contact is the membership as it was right before the removal.
No event: Deleting the contact (contact.deleted says that its memberships are gone too), and deleting the list (the list’s memberships are kept).
Setting: on_contact_removed_from_list (Contact Removed from List 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:readandlists: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.removed_from_list 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