Eventos de contactos
Contactos creados, actualizados o eliminados.
contact.created
Se envía cuando se crea un contacto con Crear un contacto. Si indicas audiences, Emailit también envía subscriber.created por cada lista de contactos.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre contact.created.
objectobjectEl contacto que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de contacto
idstringEl ID del contacto (con_…).
objectstringSiempre contact.
emailstringLa dirección del contacto, en minúsculas.
first_namestring | nullEl nombre.
last_namestring | nullLos apellidos.
custom_fieldsobjectLos valores de los campos personalizados, indexados por campo. Consulta Campos personalizados.
unsubscribedbooleanSi el contacto se ha dado de baja de todas las campañas.
created_atstringCuándo se creó el contacto, en formato ISO 8601 con desfase respecto a UTC.
audiencesobject[]Las listas de contactos a las que pertenece el contacto. Cada elemento tiene el id de la lista y un objeto subscriber con id, subscribed, subscribed_at y 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
Se envía cuando cambia un contacto, con Actualizar un contacto o con las acciones unsubscribe y resubscribe de las acciones masivas de contactos. Los cambios en las listas de contactos también envían eventos de suscriptores.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre contact.updated.
objectobjectEl contacto que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de contacto
idstringEl ID del contacto (con_…).
objectstringSiempre contact.
emailstringLa dirección del contacto, en minúsculas.
first_namestring | nullEl nombre.
last_namestring | nullLos apellidos.
custom_fieldsobjectLos valores de los campos personalizados, indexados por campo. Consulta Campos personalizados.
unsubscribedbooleanSi el contacto se ha dado de baja de todas las campañas.
updated_atstringCuándo se actualizó el contacto por última vez, en formato ISO 8601 con desfase respecto a UTC.
created_atstringCuándo se creó el contacto.
audiencesobject[]Las listas de contactos a las que pertenece el contacto. Cada elemento tiene el id de la lista y un objeto subscriber con id, subscribed, subscribed_at y unsubscribed_at.
previousobjectLos valores anteriores de los campos que cambiaron entre email, first_name, last_name, unsubscribed y custom_fields. Se omite si no cambió ninguno de ellos.
{
"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
Se envía cuando se elimina un contacto con Eliminar un contacto o con la acción masiva delete. Antes, Emailit envía subscriber.deleted por cada lista de contactos a la que pertenecía el contacto.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre contact.deleted.
objectobjectEl contacto que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de contacto
idstringEl ID del contacto (con_…).
objectstringSiempre contact.
emailstringLa dirección del contacto, en minúsculas.
first_namestring | nullEl nombre.
last_namestring | nullLos apellidos.
custom_fieldsobjectLos valores de los campos personalizados, indexados por campo. Consulta Campos personalizados.
unsubscribedbooleanSi el contacto se ha dado de baja de todas las campañas.
updated_atstringCuándo se actualizó el contacto por última vez, en formato ISO 8601 con desfase respecto a UTC.
created_atstringCuándo se creó el contacto.
audiencesobject[]Las listas de contactos a las que pertenece el contacto. Cada elemento tiene el id de la lista y un objeto subscriber con id, subscribed, subscribed_at y 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
}
}
]
}
}
}