Saltar al contenido
Docs

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 Añadir un suscriptor, 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 y subscriber.resubscribed en su lugar.

Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.

Campos

event_idstring

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.

typestring

Siempre subscriber.created.

objectobject

El suscriptor que describe el evento. Sus campos se indican a continuación.

data.objectobject

El mismo objeto otra vez, con la forma que devuelve la API de eventos en data.

Objeto de suscriptor

idstring

El ID del suscriptor (sub_…). Un suscriptor es la pertenencia de un contacto a una lista de contactos.

objectstring

Siempre subscriber.

subscribedboolean

Si el contacto está suscrito a la lista.

subscribed_atstring | null

Cuándo se suscribió el contacto, o null.

unsubscribed_atstring | null

Cuándo se dio de baja el contacto, o null.

audienceobject

El id y el name de la lista de contactos.

contactobject

El contacto: id, email, first_name, last_name y custom_fields.

created_atstring

Cuándo se añadió el contacto a la lista, en formato ISO 8601 con desfase respecto a UTC.

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"
    }
  }
}

subscriber.updated

Se envía cuando cambia un suscriptor: lo actualizas con Actualizar un suscriptor, 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.

Campos

event_idstring

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.

typestring

Siempre subscriber.updated.

objectobject

El suscriptor que describe el evento. Sus campos se indican a continuación.

data.objectobject

El mismo objeto otra vez, con la forma que devuelve la API de eventos en data.

Objeto de suscriptor

idstring

El ID del suscriptor (sub_…). Un suscriptor es la pertenencia de un contacto a una lista de contactos.

objectstring

Siempre subscriber.

subscribedboolean

Si el contacto está suscrito a la lista.

subscribed_atstring | null

Cuándo se suscribió el contacto, o null.

unsubscribed_atstring | null

Cuándo se dio de baja el contacto, o null.

audienceobject

El id y el name de la lista de contactos.

contactobject

El contacto: id, email, first_name, last_name y custom_fields.

updated_atstring

Cuándo se actualizó el suscriptor por última vez, en formato ISO 8601 con desfase respecto a UTC.

created_atstring

Cuándo se añadió el contacto a la lista.

previousobject

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.

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
      }
    }
  }
}

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. Emailit también envía 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.

Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.

Campos

event_idstring

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.

typestring

Siempre subscriber.resubscribed.

objectobject

El suscriptor que describe el evento. Sus campos se indican a continuación.

data.objectobject

El mismo objeto otra vez, con la forma que devuelve la API de eventos en data.

Objeto de suscriptor

idstring

El ID del suscriptor (sub_…). Un suscriptor es la pertenencia de un contacto a una lista de contactos.

objectstring

Siempre subscriber.

subscribedboolean

Si el contacto está suscrito a la lista.

subscribed_atstring | null

Cuándo se suscribió el contacto, o null.

unsubscribed_atstring | null

Cuándo se dio de baja el contacto, o null.

audienceobject

El id y el name de la lista de contactos.

contactobject

El contacto: id, email, first_name, last_name y custom_fields.

updated_atstring

Cuándo se actualizó el suscriptor por última vez, en formato ISO 8601 con desfase respecto a UTC.

created_atstring

Cuándo se añadió el contacto a la lista.

resubscribedboolean

Siempre true.

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
    }
  }
}

subscriber.deleted

Se envía cuando se quita un contacto de una lista de contactos: con Eliminar un suscriptor, 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.

Campos

event_idstring

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.

typestring

Siempre subscriber.deleted.

objectobject

El suscriptor que describe el evento. Sus campos se indican a continuación.

data.objectobject

El mismo objeto otra vez, con la forma que devuelve la API de eventos en data.

Objeto de suscriptor

idstring

El ID del suscriptor (sub_…). Un suscriptor es la pertenencia de un contacto a una lista de contactos.

objectstring

Siempre subscriber.

subscribedboolean

Si el contacto está suscrito a la lista.

subscribed_atstring | null

Cuándo se suscribió el contacto, o null.

unsubscribed_atstring | null

Cuándo se dio de baja el contacto, o null.

audienceobject

El id y el name de la lista de contactos.

contactobject

El contacto: id, email, first_name, last_name y custom_fields.

updated_atstring

Cuándo se actualizó el suscriptor por última vez, en formato ISO 8601 con desfase respecto a UTC.

created_atstring

Cuándo se añadió el contacto a la lista.

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"
    }
  }
}

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.

Esc

Populares

↑↓para moverte↵para abrirEscpara cerrar