Saltar al contenido
Docs

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_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 contact.created.

objectobject

El contacto 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 contacto

idstring

El ID del contacto (con_…).

objectstring

Siempre contact.

emailstring

La dirección del contacto, en minúsculas.

first_namestring | null

El nombre.

last_namestring | null

Los apellidos.

custom_fieldsobject

Los valores de los campos personalizados, indexados por campo. Consulta Campos personalizados.

unsubscribedboolean

Si el contacto se ha dado de baja de todas las campañas.

created_atstring

Cuá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.

JSON
{
  "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_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 contact.updated.

objectobject

El contacto 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 contacto

idstring

El ID del contacto (con_…).

objectstring

Siempre contact.

emailstring

La dirección del contacto, en minúsculas.

first_namestring | null

El nombre.

last_namestring | null

Los apellidos.

custom_fieldsobject

Los valores de los campos personalizados, indexados por campo. Consulta Campos personalizados.

unsubscribedboolean

Si el contacto se ha dado de baja de todas las campañas.

updated_atstring

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

created_atstring

Cuá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.

previousobject

Los 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.

JSON
{
  "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_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 contact.deleted.

objectobject

El contacto 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 contacto

idstring

El ID del contacto (con_…).

objectstring

Siempre contact.

emailstring

La dirección del contacto, en minúsculas.

first_namestring | null

El nombre.

last_namestring | null

Los apellidos.

custom_fieldsobject

Los valores de los campos personalizados, indexados por campo. Consulta Campos personalizados.

unsubscribedboolean

Si el contacto se ha dado de baja de todas las campañas.

updated_atstring

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

created_atstring

Cuá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.

JSON
{
  "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
          }
        }
      ]
    }
  }
}

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.