Contact events
Contacts created, updated or deleted.
contact.created
Sent when a contact is created with Create a contact. If you pass audiences, Emailit also sends subscriber.created for each audience.
Webhook requests carry a JSON array of events like this one; see Webhook requests.
Fields
event_idstringEvent ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.
typestringAlways contact.created.
objectobjectThe contact the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Contact object
idstringContact ID (con_…).
objectstringAlways contact.
emailstringContact address, in lowercase.
first_namestring | nullFirst name.
last_namestring | nullLast name.
custom_fieldsobjectCustom field values keyed by field. See Custom fields.
unsubscribedbooleanWhether the contact is unsubscribed from all campaigns.
created_atstringWhen the contact was created, in ISO 8601 with a UTC offset.
audiencesobject[]Audiences the contact belongs to. Each item has the audience id and a subscriber object with id, subscribed, subscribed_at and unsubscribed_at.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "contact.created",
"object": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"object": "contact",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"company": "Analytical Engines"
},
"unsubscribed": false,
"created_at": "2026-09-20T14:22:09.418000+00:00",
"audiences": [
{
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"subscriber": {
"id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
"subscribed": true,
"subscribed_at": "2026-09-20T14:22:09.418302+00:00",
"unsubscribed_at": null
}
}
]
},
"data": {
"object": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"object": "contact",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"company": "Analytical Engines"
},
"unsubscribed": false,
"created_at": "2026-09-20T14:22:09.418000+00:00",
"audiences": [
{
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"subscriber": {
"id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
"subscribed": true,
"subscribed_at": "2026-09-20T14:22:09.418302+00:00",
"unsubscribed_at": null
}
}
]
}
}
}contact.updated
Sent when a contact changes, with Update a contact or the unsubscribe and resubscribe actions of bulk contact actions. Audience changes also send subscriber events.
Webhook requests carry a JSON array of events like this one; see Webhook requests.
Fields
event_idstringEvent ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.
typestringAlways contact.updated.
objectobjectThe contact the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Contact object
idstringContact ID (con_…).
objectstringAlways contact.
emailstringContact address, in lowercase.
first_namestring | nullFirst name.
last_namestring | nullLast name.
custom_fieldsobjectCustom field values keyed by field. See Custom fields.
unsubscribedbooleanWhether the contact is unsubscribed from all campaigns.
updated_atstringWhen the contact was last updated, in ISO 8601 with a UTC offset.
created_atstringWhen the contact was created.
audiencesobject[]Audiences the contact belongs to. Each item has the audience id and a subscriber object with id, subscribed, subscribed_at and unsubscribed_at.
previousobjectOld values of the fields that changed among email, first_name, last_name, unsubscribed and custom_fields. Omitted when none of them changed.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "contact.updated",
"object": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"object": "contact",
"email": "ada@example.com",
"first_name": "Augusta Ada",
"last_name": "Lovelace",
"custom_fields": {
"company": "Analytical Engines"
},
"unsubscribed": false,
"updated_at": "2026-10-01T10:02:14.307000+00:00",
"created_at": "2026-09-20T14:22:09.418000+00:00",
"audiences": [
{
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"subscriber": {
"id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
"subscribed": true,
"subscribed_at": "2026-09-20T14:22:09.418302+00:00",
"unsubscribed_at": null
}
}
],
"previous": {
"first_name": "Ada"
}
},
"data": {
"object": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"object": "contact",
"email": "ada@example.com",
"first_name": "Augusta Ada",
"last_name": "Lovelace",
"custom_fields": {
"company": "Analytical Engines"
},
"unsubscribed": false,
"updated_at": "2026-10-01T10:02:14.307000+00:00",
"created_at": "2026-09-20T14:22:09.418000+00:00",
"audiences": [
{
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"subscriber": {
"id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
"subscribed": true,
"subscribed_at": "2026-09-20T14:22:09.418302+00:00",
"unsubscribed_at": null
}
}
],
"previous": {
"first_name": "Ada"
}
}
}
}contact.deleted
Sent when a contact is deleted with Delete a contact or the bulk delete action. Emailit first sends subscriber.deleted for each audience the contact belonged to.
Webhook requests carry a JSON array of events like this one; see Webhook requests.
Fields
event_idstringEvent ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.
typestringAlways contact.deleted.
objectobjectThe contact the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Contact object
idstringContact ID (con_…).
objectstringAlways contact.
emailstringContact address, in lowercase.
first_namestring | nullFirst name.
last_namestring | nullLast name.
custom_fieldsobjectCustom field values keyed by field. See Custom fields.
unsubscribedbooleanWhether the contact is unsubscribed from all campaigns.
updated_atstringWhen the contact was last updated, in ISO 8601 with a UTC offset.
created_atstringWhen the contact was created.
audiencesobject[]Audiences the contact belongs to. Each item has the audience id and a subscriber object with id, subscribed, subscribed_at and unsubscribed_at.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "contact.deleted",
"object": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"object": "contact",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"company": "Analytical Engines"
},
"unsubscribed": false,
"updated_at": "2026-09-30T16:48:55.120000+00:00",
"created_at": "2026-09-20T14:22:09.418000+00:00",
"audiences": [
{
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"subscriber": {
"id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
"subscribed": true,
"subscribed_at": "2026-09-20T14:22:09.418302+00:00",
"unsubscribed_at": null
}
}
]
},
"data": {
"object": {
"id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
"object": "contact",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": {
"company": "Analytical Engines"
},
"unsubscribed": false,
"updated_at": "2026-09-30T16:48:55.120000+00:00",
"created_at": "2026-09-20T14:22:09.418000+00:00",
"audiences": [
{
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"subscriber": {
"id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
"subscribed": true,
"subscribed_at": "2026-09-20T14:22:09.418302+00:00",
"unsubscribed_at": null
}
}
]
}
}
}