# Eventos de suscriptores > Contactos añadidos a una lista de contactos, modificados en ella, añadidos de nuevo o quitados de ella. ## subscriber.created > Se envía cuando se añade un contacto a una lista de contactos, con la API, en el panel o al crear un contacto con listas. # subscriber.created Se envía cuando se añade un contacto a una lista de contactos con [Añadir un suscriptor](/es/docs/api-reference/audiences/subscribers/add/), o cuando creas o actualizas un contacto con `audiences`. Si añades un contacto que se había dado de baja de la lista, se envían [`subscriber.updated`](/es/docs/webhooks/events/subscriber/updated/) y [`subscriber.resubscribed`](/es/docs/webhooks/events/subscriber/resubscribed/) en su lugar. Las peticiones de webhook contienen un array JSON de eventos como este; consulta [Peticiones de webhook](/es/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a", "type": "subscriber.created", "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": true, "subscribed_at": "2026-09-20T14:22:09.418302+00:00", "unsubscribed_at": null, "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "created_at": "2026-09-20T14:22:09.418302+00:00" }, "data": { "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": true, "subscribed_at": "2026-09-20T14:22:09.418302+00:00", "unsubscribed_at": null, "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "created_at": "2026-09-20T14:22:09.418302+00:00" } } } ``` ## Campos - `event_id` (string): El 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](/es/docs/api-reference/events/get/). - `type` (string): Siempre `subscriber.created`. - `object` (object): El suscriptor que describe el evento. Sus campos se indican a continuación. - `data.object` (object): El mismo objeto otra vez, con la forma que devuelve la [API de eventos](/es/docs/api-reference/events/get/) en `data`. ### Objeto de suscriptor - `id` (string): El ID del suscriptor (`sub_…`). Un suscriptor es la pertenencia de un contacto a una lista de contactos. - `object` (string): Siempre `subscriber`. - `subscribed` (boolean): Si el contacto está suscrito a la lista. - `subscribed_at` (string | null): Cuándo se suscribió el contacto, o `null`. - `unsubscribed_at` (string | null): Cuándo se dio de baja el contacto, o `null`. - `audience` (object): El `id` y el `name` de la lista de contactos. - `contact` (object): El contacto: `id`, `email`, `first_name`, `last_name` y `custom_fields`. - `created_at` (string): Cuándo se añadió el contacto a la lista, en formato ISO 8601 con desfase respecto a UTC. --- Fuente: https://emailit.com/es/docs/webhooks/events/subscriber/subscriber-created/ ## subscriber.updated > Se envía cuando cambia un suscriptor, también cuando el contacto se da de baja de una lista de contactos o vuelve a ella. # subscriber.updated Se envía cuando cambia un suscriptor: lo actualizas con [Actualizar un suscriptor](/es/docs/api-reference/audiences/subscribers/update/), el contacto se da de baja o vuelve a suscribirse, o se vuelve a añadir a la lista un contacto que se había dado de baja. Cuando el cambio se debe a una baja o a una nueva suscripción, `previous` contiene los valores anteriores. Las peticiones de webhook contienen un array JSON de eventos como este; consulta [Peticiones de webhook](/es/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a", "type": "subscriber.updated", "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": false, "subscribed_at": "2026-09-20T14:22:09.418302+00:00", "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00", "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "updated_at": "2026-10-01T10:02:14.307000+00:00", "created_at": "2026-09-20T14:22:09.418302+00:00", "previous": { "subscribed": true, "unsubscribed_at": null } }, "data": { "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": false, "subscribed_at": "2026-09-20T14:22:09.418302+00:00", "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00", "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "updated_at": "2026-10-01T10:02:14.307000+00:00", "created_at": "2026-09-20T14:22:09.418302+00:00", "previous": { "subscribed": true, "unsubscribed_at": null } } } } ``` ## Campos - `event_id` (string): El 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](/es/docs/api-reference/events/get/). - `type` (string): Siempre `subscriber.updated`. - `object` (object): El suscriptor que describe el evento. Sus campos se indican a continuación. - `data.object` (object): El mismo objeto otra vez, con la forma que devuelve la [API de eventos](/es/docs/api-reference/events/get/) en `data`. ### Objeto de suscriptor - `id` (string): El ID del suscriptor (`sub_…`). Un suscriptor es la pertenencia de un contacto a una lista de contactos. - `object` (string): Siempre `subscriber`. - `subscribed` (boolean): Si el contacto está suscrito a la lista. - `subscribed_at` (string | null): Cuándo se suscribió el contacto, o `null`. - `unsubscribed_at` (string | null): Cuándo se dio de baja el contacto, o `null`. - `audience` (object): El `id` y el `name` de la lista de contactos. - `contact` (object): El contacto: `id`, `email`, `first_name`, `last_name` y `custom_fields`. - `updated_at` (string): Cuándo se actualizó el suscriptor por última vez, en formato ISO 8601 con desfase respecto a UTC. - `created_at` (string): Cuándo se añadió el contacto a la lista. - `previous` (object): Los valores anteriores, incluidos cuando el contacto se dio de baja o volvió a suscribirse: `subscribed` y `unsubscribed_at`. Se omite en los demás cambios. --- Fuente: https://emailit.com/es/docs/webhooks/events/subscriber/subscriber-updated/ ## subscriber.resubscribed > Se envía cuando vuelves a añadir un contacto a una lista de contactos de la que se había dado de baja. No figura en la lista de eventos del panel. # subscriber.resubscribed Se envía cuando añades un contacto a una lista de contactos de la que se había dado de baja, con [Añadir un suscriptor](/es/docs/api-reference/audiences/subscribers/add/). Emailit también envía [`subscriber.updated`](/es/docs/webhooks/events/subscriber/updated/) con el mismo suscriptor. `subscriber.resubscribed` no está en la lista de eventos del panel. Lo recibes en los webhooks que tienen `all_events` activado o si lo añades a `events` con [Actualizar un webhook](/es/docs/api-reference/webhooks/update/). Las peticiones de webhook contienen un array JSON de eventos como este; consulta [Peticiones de webhook](/es/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a", "type": "subscriber.resubscribed", "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": true, "subscribed_at": "2026-10-01T10:02:14.307000+00:00", "unsubscribed_at": null, "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "updated_at": "2026-10-01T10:02:14.307000+00:00", "created_at": "2026-09-20T14:22:09.418302+00:00", "resubscribed": true }, "data": { "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": true, "subscribed_at": "2026-10-01T10:02:14.307000+00:00", "unsubscribed_at": null, "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "updated_at": "2026-10-01T10:02:14.307000+00:00", "created_at": "2026-09-20T14:22:09.418302+00:00", "resubscribed": true } } } ``` ## Campos - `event_id` (string): El 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](/es/docs/api-reference/events/get/). - `type` (string): Siempre `subscriber.resubscribed`. - `object` (object): El suscriptor que describe el evento. Sus campos se indican a continuación. - `data.object` (object): El mismo objeto otra vez, con la forma que devuelve la [API de eventos](/es/docs/api-reference/events/get/) en `data`. ### Objeto de suscriptor - `id` (string): El ID del suscriptor (`sub_…`). Un suscriptor es la pertenencia de un contacto a una lista de contactos. - `object` (string): Siempre `subscriber`. - `subscribed` (boolean): Si el contacto está suscrito a la lista. - `subscribed_at` (string | null): Cuándo se suscribió el contacto, o `null`. - `unsubscribed_at` (string | null): Cuándo se dio de baja el contacto, o `null`. - `audience` (object): El `id` y el `name` de la lista de contactos. - `contact` (object): El contacto: `id`, `email`, `first_name`, `last_name` y `custom_fields`. - `updated_at` (string): Cuándo se actualizó el suscriptor por última vez, en formato ISO 8601 con desfase respecto a UTC. - `created_at` (string): Cuándo se añadió el contacto a la lista. - `resubscribed` (boolean): Siempre `true`. --- Fuente: https://emailit.com/es/docs/webhooks/events/subscriber/subscriber-resubscribed/ ## subscriber.deleted > Se envía cuando se quita un contacto de una lista de contactos, también cuando se elimina el propio contacto. # subscriber.deleted Se envía cuando se quita un contacto de una lista de contactos: con [Eliminar un suscriptor](/es/docs/api-reference/audiences/subscribers/delete/), cuando cambias las `audiences` de un contacto o cuando eliminas el contacto. El payload es el suscriptor tal como estaba antes de quitarlo. Las peticiones de webhook contienen un array JSON de eventos como este; consulta [Peticiones de webhook](/es/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a", "type": "subscriber.deleted", "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": true, "subscribed_at": "2026-09-20T14:22:09.418302+00:00", "unsubscribed_at": null, "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "updated_at": "2026-09-20T14:22:09.418302+00:00", "created_at": "2026-09-20T14:22:09.418302+00:00" }, "data": { "object": { "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j", "object": "subscriber", "subscribed": true, "subscribed_at": "2026-09-20T14:22:09.418302+00:00", "unsubscribed_at": null, "audience": { "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i", "name": "Newsletter" }, "contact": { "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a", "email": "ada@example.com", "first_name": "Ada", "last_name": "Lovelace", "custom_fields": { "company": "Analytical Engines" } }, "updated_at": "2026-09-20T14:22:09.418302+00:00", "created_at": "2026-09-20T14:22:09.418302+00:00" } } } ``` ## Campos - `event_id` (string): El 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](/es/docs/api-reference/events/get/). - `type` (string): Siempre `subscriber.deleted`. - `object` (object): El suscriptor que describe el evento. Sus campos se indican a continuación. - `data.object` (object): El mismo objeto otra vez, con la forma que devuelve la [API de eventos](/es/docs/api-reference/events/get/) en `data`. ### Objeto de suscriptor - `id` (string): El ID del suscriptor (`sub_…`). Un suscriptor es la pertenencia de un contacto a una lista de contactos. - `object` (string): Siempre `subscriber`. - `subscribed` (boolean): Si el contacto está suscrito a la lista. - `subscribed_at` (string | null): Cuándo se suscribió el contacto, o `null`. - `unsubscribed_at` (string | null): Cuándo se dio de baja el contacto, o `null`. - `audience` (object): El `id` y el `name` de la lista de contactos. - `contact` (object): El contacto: `id`, `email`, `first_name`, `last_name` y `custom_fields`. - `updated_at` (string): Cuándo se actualizó el suscriptor por última vez, en formato ISO 8601 con desfase respecto a UTC. - `created_at` (string): Cuándo se añadió el contacto a la lista. --- Fuente: https://emailit.com/es/docs/webhooks/events/subscriber/subscriber-deleted/