{
"type": "contact.updated",
"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"
},
"changed_fields": [
"first_name"
]
}
}Contact Events
contact.updated Webhook Event
The contact.updated webhook fires when a field of an AhaSend contact changes. It lists the changed fields. Validation results and imports send no event.
WEBHOOK
contact.updated
{
"type": "contact.updated",
"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"
},
"changed_fields": [
"first_name"
]
}
}AhaSend sends this event when a field of a contact changes:
Setting:
email, first_name, last_name, status, status_reason, or attributes.
data.contact is the contact as it was right after the change. data.changed_fields lists the fields whose values changed; a change to any key of attributes lists attributes. In rare cases, when two batch requests write the same new contact at the same time, changed_fields lists every field that the later request set.
A bounce or an expired message that disables the contact sends this event with origin: system.
No event:
- A write that changes no field, or that changes only
updated_at - The unsubscribe from all lists (
unsubscribedandunsubscribed_at), which sendscontact.unsubscribedorcontact.subscribed - Email validation results (
validation_statusandlast_validated_at). A validation that blocks a contact changes itsstatus, and that sends this event. - A CSV import, and removing a contact field from all contacts
A handler that writes the contact back through the API receives its own write as a new
contact.updated event. See prevent loops.on_contact_updated (Contact Updated 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.updated 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