# Eventos de contato

> Contatos criados, atualizados ou excluídos.



## contact.created

> Enviado quando um contato é criado pela API ou no painel. Inclui as listas de contatos às quais ele foi adicionado.

# contact.created

Enviado quando um contato é criado com [Criar um contato](/pt/docs/api-reference/contacts/create/). Se você passar `audiences`, o Emailit também envia [`subscriber.created`](/pt/docs/webhooks/events/subscriber/created/) para cada lista.

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/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): ID do evento (`evt_…`). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com [Obter um evento](/pt/docs/api-reference/events/get/).

- `type` (string): Sempre `contact.created`.

- `object` (object): O contato que o evento descreve. Os campos dele estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de contato

- `id` (string): ID do contato (`con_…`).

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

- `email` (string): Endereço de e-mail do contato, em minúsculas.

- `first_name` (string | null): Nome.

- `last_name` (string | null): Sobrenome.

- `custom_fields` (object): Valores dos campos personalizados, indexados pelo campo. Consulte [Campos personalizados](/pt/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Se o contato está descadastrado de todas as campanhas.

- `created_at` (string): Quando o contato foi criado, em ISO 8601 com deslocamento UTC.

- `audiences` (object[]): Listas de contatos às quais o contato pertence. Cada item tem o `id` da lista e um objeto `subscriber` com `id`, `subscribed`, `subscribed_at` e `unsubscribed_at`.

---
Fonte: https://emailit.com/pt/docs/webhooks/events/contact/contact-created/

## contact.updated

> Enviado quando um contato muda. Inclui os valores anteriores dos campos que mudaram, como o endereço de e-mail ou o nome.

# contact.updated

Enviado quando um contato muda, com [Atualizar um contato](/pt/docs/api-reference/contacts/update/) ou com as ações `unsubscribe` e `resubscribe` das [ações em massa de contatos](/pt/docs/api-reference/contacts/bulk/). Mudanças nas listas de contatos também enviam [eventos de inscrito](/pt/docs/webhooks/events/subscriber/).

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/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): ID do evento (`evt_…`). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com [Obter um evento](/pt/docs/api-reference/events/get/).

- `type` (string): Sempre `contact.updated`.

- `object` (object): O contato que o evento descreve. Os campos dele estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de contato

- `id` (string): ID do contato (`con_…`).

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

- `email` (string): Endereço de e-mail do contato, em minúsculas.

- `first_name` (string | null): Nome.

- `last_name` (string | null): Sobrenome.

- `custom_fields` (object): Valores dos campos personalizados, indexados pelo campo. Consulte [Campos personalizados](/pt/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Se o contato está descadastrado de todas as campanhas.

- `updated_at` (string): Quando o contato foi atualizado pela última vez, em ISO 8601 com deslocamento UTC.

- `created_at` (string): Quando o contato foi criado.

- `audiences` (object[]): Listas de contatos às quais o contato pertence. Cada item tem o `id` da lista e um objeto `subscriber` com `id`, `subscribed`, `subscribed_at` e `unsubscribed_at`.

- `previous` (object): Valores antigos dos campos que mudaram entre `email`, `first_name`, `last_name`, `unsubscribed` e `custom_fields`. Omitido quando nenhum deles mudou.

---
Fonte: https://emailit.com/pt/docs/webhooks/events/contact/contact-updated/

## contact.deleted

> Enviado quando um contato é excluído. O payload é o contato, com as listas dele, como era antes da exclusão.

# contact.deleted

Enviado quando um contato é excluído com [Excluir um contato](/pt/docs/api-reference/contacts/delete/) ou com a ação em massa `delete`. Antes, o Emailit envia [`subscriber.deleted`](/pt/docs/webhooks/events/subscriber/deleted/) para cada lista de que o contato fazia parte.

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/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): ID do evento (`evt_…`). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com [Obter um evento](/pt/docs/api-reference/events/get/).

- `type` (string): Sempre `contact.deleted`.

- `object` (object): O contato que o evento descreve. Os campos dele estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de contato

- `id` (string): ID do contato (`con_…`).

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

- `email` (string): Endereço de e-mail do contato, em minúsculas.

- `first_name` (string | null): Nome.

- `last_name` (string | null): Sobrenome.

- `custom_fields` (object): Valores dos campos personalizados, indexados pelo campo. Consulte [Campos personalizados](/pt/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Se o contato está descadastrado de todas as campanhas.

- `updated_at` (string): Quando o contato foi atualizado pela última vez, em ISO 8601 com deslocamento UTC.

- `created_at` (string): Quando o contato foi criado.

- `audiences` (object[]): Listas de contatos às quais o contato pertence. Cada item tem o `id` da lista e um objeto `subscriber` com `id`, `subscribed`, `subscribed_at` e `unsubscribed_at`.

---
Fonte: https://emailit.com/pt/docs/webhooks/events/contact/contact-deleted/
