Eventos de listas de contactos
Listas de contactos creadas, actualizadas o eliminadas.
audience.created
Se envía cuando se crea una lista de contactos, por ejemplo con Crear una 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 audience.created.
objectobjectLa lista de contactos 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 lista de contactos
idstringEl ID de la lista de contactos (aud_…).
objectstringSiempre audience.
namestringEl nombre de la lista de contactos.
created_atstringCuándo se creó la lista de contactos, en formato ISO 8601 con desfase respecto a UTC.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "audience.created",
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Newsletter",
"created_at": "2026-10-01T10:02:11.583000+00:00"
},
"data": {
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Newsletter",
"created_at": "2026-10-01T10:02:11.583000+00:00"
}
}
}audience.updated
Se envía cuando cambia una lista de contactos, por ejemplo cuando le cambias el nombre con Actualizar una lista de contactos. Los cambios en los suscriptores envían eventos de suscriptores en su lugar.
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 audience.updated.
objectobjectLa lista de contactos 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 lista de contactos
idstringEl ID de la lista de contactos (aud_…).
objectstringSiempre audience.
namestringEl nombre de la lista de contactos.
updated_atstringCuándo se actualizó la lista de contactos por última vez, en formato ISO 8601 con desfase respecto a UTC.
created_atstringCuándo se creó la lista de contactos.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "audience.updated",
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-10-01T10:02:14.307000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
},
"data": {
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-10-01T10:02:14.307000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
}
}
}audience.deleted
Se envía cuando se elimina una lista de contactos, por ejemplo con Eliminar una lista de contactos. El payload es la lista tal como estaba antes de eliminarse.
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 audience.deleted.
objectobjectLa lista de contactos 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 lista de contactos
idstringEl ID de la lista de contactos (aud_…).
objectstringSiempre audience.
namestringEl nombre de la lista de contactos.
updated_atstringCuándo se actualizó la lista de contactos por última vez, en formato ISO 8601 con desfase respecto a UTC.
created_atstringCuándo se creó la lista de contactos.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "audience.deleted",
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-09-30T08:14:02.771000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
},
"data": {
"object": {
"id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
"object": "audience",
"name": "Monthly newsletter",
"updated_at": "2026-09-30T08:14:02.771000+00:00",
"created_at": "2026-09-15T12:00:41.305000+00:00"
}
}
}