Eventi dei contatti
Contatti creati, aggiornati o eliminati.
contact.created
Inviato quando viene creato un contatto con Crea un contatto. Se passi audiences, Emailit invia anche subscriber.created per ogni lista.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre contact.created.
objectobjectIl contatto descritto dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto contatto
idstringID del contatto (con_…).
objectstringSempre contact.
emailstringIndirizzo del contatto, in minuscolo.
first_namestring | nullNome.
last_namestring | nullCognome.
custom_fieldsobjectValori dei campi personalizzati, indicizzati per campo. Vedi Campi personalizzati.
unsubscribedbooleanIndica se il contatto è disiscritto da tutte le campagne.
created_atstringQuando è stato creato il contatto, in formato ISO 8601 con offset UTC.
audiencesobject[]Liste a cui appartiene il contatto. Ogni elemento contiene l’id della lista e un oggetto subscriber con id, subscribed, subscribed_at e 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
Inviato quando un contatto cambia, con Aggiorna un contatto o con le azioni unsubscribe e resubscribe delle azioni di massa sui contatti. Le modifiche alle liste generano anche gli eventi degli iscritti.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre contact.updated.
objectobjectIl contatto descritto dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto contatto
idstringID del contatto (con_…).
objectstringSempre contact.
emailstringIndirizzo del contatto, in minuscolo.
first_namestring | nullNome.
last_namestring | nullCognome.
custom_fieldsobjectValori dei campi personalizzati, indicizzati per campo. Vedi Campi personalizzati.
unsubscribedbooleanIndica se il contatto è disiscritto da tutte le campagne.
updated_atstringQuando è stato aggiornato l’ultima volta il contatto, in formato ISO 8601 con offset UTC.
created_atstringQuando è stato creato il contatto.
audiencesobject[]Liste a cui appartiene il contatto. Ogni elemento contiene l’id della lista e un oggetto subscriber con id, subscribed, subscribed_at e unsubscribed_at.
previousobjectValori precedenti dei campi modificati tra email, first_name, last_name, unsubscribed e custom_fields. Omesso se nessuno di questi campi è cambiato.
{
"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
Inviato quando viene eliminato un contatto con Elimina un contatto o con l’azione di massa delete. Prima Emailit invia subscriber.deleted per ogni lista a cui apparteneva il contatto.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre contact.deleted.
objectobjectIl contatto descritto dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto contatto
idstringID del contatto (con_…).
objectstringSempre contact.
emailstringIndirizzo del contatto, in minuscolo.
first_namestring | nullNome.
last_namestring | nullCognome.
custom_fieldsobjectValori dei campi personalizzati, indicizzati per campo. Vedi Campi personalizzati.
unsubscribedbooleanIndica se il contatto è disiscritto da tutte le campagne.
updated_atstringQuando è stato aggiornato l’ultima volta il contatto, in formato ISO 8601 con offset UTC.
created_atstringQuando è stato creato il contatto.
audiencesobject[]Liste a cui appartiene il contatto. Ogni elemento contiene l’id della lista e un oggetto subscriber con id, subscribed, subscribed_at e 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
}
}
]
}
}
}