# Eventos de contactos

> Contactos creados, actualizados o eliminados.



## contact.created

> Se envía cuando se crea un contacto con la API o en el panel. Incluye las listas de contactos a las que se añadió.

# contact.created

Se envía cuando se crea un contacto con [Crear un contacto](/es/docs/api-reference/contacts/create/). Si indicas `audiences`, Emailit también envía [`subscriber.created`](/es/docs/webhooks/events/subscriber/created/) por cada lista de contactos.

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": "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
          }
        }
      ]
    }
  }
}
```

## 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 `contact.created`.

- `object` (object): El contacto 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 contacto

- `id` (string): El ID del contacto (`con_…`).

- `object` (string): Siempre `contact`.

- `email` (string): La dirección del contacto, en minúsculas.

- `first_name` (string | null): El nombre.

- `last_name` (string | null): Los apellidos.

- `custom_fields` (object): Los valores de los campos personalizados, indexados por campo. Consulta [Campos personalizados](/es/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Si el contacto se ha dado de baja de todas las campañas.

- `created_at` (string): Cuándo se creó el contacto, en formato ISO 8601 con desfase respecto a UTC.

- `audiences` (object[]): 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`.

---
Fuente: https://emailit.com/es/docs/webhooks/events/contact/contact-created/

## contact.updated

> Se envía cuando cambia un contacto. Incluye los valores anteriores de los campos que cambiaron, como la dirección de email o el nombre.

# contact.updated

Se envía cuando cambia un contacto, con [Actualizar un contacto](/es/docs/api-reference/contacts/update/) o con las acciones `unsubscribe` y `resubscribe` de las [acciones masivas de contactos](/es/docs/api-reference/contacts/bulk/). Los cambios en las listas de contactos también envían [eventos de suscriptores](/es/docs/webhooks/events/subscriber/).

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

## 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 `contact.updated`.

- `object` (object): El contacto 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 contacto

- `id` (string): El ID del contacto (`con_…`).

- `object` (string): Siempre `contact`.

- `email` (string): La dirección del contacto, en minúsculas.

- `first_name` (string | null): El nombre.

- `last_name` (string | null): Los apellidos.

- `custom_fields` (object): Los valores de los campos personalizados, indexados por campo. Consulta [Campos personalizados](/es/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Si el contacto se ha dado de baja de todas las campañas.

- `updated_at` (string): Cuándo se actualizó el contacto por última vez, en formato ISO 8601 con desfase respecto a UTC.

- `created_at` (string): Cuándo se creó el contacto.

- `audiences` (object[]): 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`.

- `previous` (object): 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.

---
Fuente: https://emailit.com/es/docs/webhooks/events/contact/contact-updated/

## contact.deleted

> Se envía cuando se elimina un contacto. El payload es el contacto, con sus listas, tal como estaba antes de eliminarse.

# contact.deleted

Se envía cuando se elimina un contacto con [Eliminar un contacto](/es/docs/api-reference/contacts/delete/) o con la acción masiva `delete`. Antes, Emailit envía [`subscriber.deleted`](/es/docs/webhooks/events/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](/es/docs/webhooks/webhook-requests/).

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

## 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 `contact.deleted`.

- `object` (object): El contacto 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 contacto

- `id` (string): El ID del contacto (`con_…`).

- `object` (string): Siempre `contact`.

- `email` (string): La dirección del contacto, en minúsculas.

- `first_name` (string | null): El nombre.

- `last_name` (string | null): Los apellidos.

- `custom_fields` (object): Los valores de los campos personalizados, indexados por campo. Consulta [Campos personalizados](/es/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Si el contacto se ha dado de baja de todas las campañas.

- `updated_at` (string): Cuándo se actualizó el contacto por última vez, en formato ISO 8601 con desfase respecto a UTC.

- `created_at` (string): Cuándo se creó el contacto.

- `audiences` (object[]): 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`.

---
Fuente: https://emailit.com/es/docs/webhooks/events/contact/contact-deleted/
