Eventos de contato
Contatos criados, atualizados ou excluídos.
contact.created
Enviado quando um contato é criado com Criar um contato. Se você passar audiences, o Emailit também envia subscriber.created para cada lista.
As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.
Campos
event_idstringID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.
typestringSempre contact.created.
objectobjectO contato que o evento descreve. Os campos dele estão listados abaixo.
data.objectobjectO mesmo objeto de novo, no formato que a API de eventos retorna em data.
Objeto de contato
idstringID do contato (con_…).
objectstringSempre contact.
emailstringEndereço de e-mail do contato, em minúsculas.
first_namestring | nullNome.
last_namestring | nullSobrenome.
custom_fieldsobjectValores dos campos personalizados, indexados pelo campo. Consulte Campos personalizados.
unsubscribedbooleanSe o contato está descadastrado de todas as campanhas.
created_atstringQuando o contato foi criado, em ISO 8601 com deslocamento UTC.
audiencesobject[]Listas de contatos às quais o contato pertence. Cada item tem o id da lista e um objeto subscriber com 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
Enviado quando um contato muda, com Atualizar um contato ou com as ações unsubscribe e resubscribe das ações em massa de contatos. Mudanças nas listas de contatos também enviam eventos de inscrito.
As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.
Campos
event_idstringID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.
typestringSempre contact.updated.
objectobjectO contato que o evento descreve. Os campos dele estão listados abaixo.
data.objectobjectO mesmo objeto de novo, no formato que a API de eventos retorna em data.
Objeto de contato
idstringID do contato (con_…).
objectstringSempre contact.
emailstringEndereço de e-mail do contato, em minúsculas.
first_namestring | nullNome.
last_namestring | nullSobrenome.
custom_fieldsobjectValores dos campos personalizados, indexados pelo campo. Consulte Campos personalizados.
unsubscribedbooleanSe o contato está descadastrado de todas as campanhas.
updated_atstringQuando o contato foi atualizado pela última vez, em ISO 8601 com deslocamento UTC.
created_atstringQuando o contato foi criado.
audiencesobject[]Listas de contatos às quais o contato pertence. Cada item tem o id da lista e um objeto subscriber com id, subscribed, subscribed_at e unsubscribed_at.
previousobjectValores antigos dos campos que mudaram entre email, first_name, last_name, unsubscribed e custom_fields. Omitido quando nenhum deles mudou.
{
"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
Enviado quando um contato é excluído com Excluir um contato ou com a ação em massa delete. Antes, o Emailit envia subscriber.deleted para cada lista de que o contato fazia parte.
As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.
Campos
event_idstringID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.
typestringSempre contact.deleted.
objectobjectO contato que o evento descreve. Os campos dele estão listados abaixo.
data.objectobjectO mesmo objeto de novo, no formato que a API de eventos retorna em data.
Objeto de contato
idstringID do contato (con_…).
objectstringSempre contact.
emailstringEndereço de e-mail do contato, em minúsculas.
first_namestring | nullNome.
last_namestring | nullSobrenome.
custom_fieldsobjectValores dos campos personalizados, indexados pelo campo. Consulte Campos personalizados.
unsubscribedbooleanSe o contato está descadastrado de todas as campanhas.
updated_atstringQuando o contato foi atualizado pela última vez, em ISO 8601 com deslocamento UTC.
created_atstringQuando o contato foi criado.
audiencesobject[]Listas de contatos às quais o contato pertence. Cada item tem o id da lista e um objeto subscriber com 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
}
}
]
}
}
}