Pular para o conteúdo
Docs

Contatos criados, atualizados ou excluídos.

contact.created

Enviado quando um contato é criado com Criar um contato. Se você passar audiences, o Emailit também envia subscriber.created para cada lista.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

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.

typestring

Sempre contact.created.

objectobject

O contato que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de contato

idstring

ID do contato (con_…).

objectstring

Sempre contact.

emailstring

Endereço de e-mail do contato, em minúsculas.

first_namestring | null

Nome.

last_namestring | null

Sobrenome.

custom_fieldsobject

Valores dos campos personalizados, indexados pelo campo. Consulte Campos personalizados.

unsubscribedboolean

Se o contato está descadastrado de todas as campanhas.

created_atstring

Quando o contato foi criado, em ISO 8601 com deslocamento UTC.

audiencesobject[]

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.

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

Enviado quando um contato muda, com Atualizar um contato ou com as ações unsubscribe e resubscribe das ações em massa de contatos. Mudanças nas listas de contatos também enviam eventos de inscrito.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

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.

typestring

Sempre contact.updated.

objectobject

O contato que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de contato

idstring

ID do contato (con_…).

objectstring

Sempre contact.

emailstring

Endereço de e-mail do contato, em minúsculas.

first_namestring | null

Nome.

last_namestring | null

Sobrenome.

custom_fieldsobject

Valores dos campos personalizados, indexados pelo campo. Consulte Campos personalizados.

unsubscribedboolean

Se o contato está descadastrado de todas as campanhas.

updated_atstring

Quando o contato foi atualizado pela última vez, em ISO 8601 com deslocamento UTC.

created_atstring

Quando o contato foi criado.

audiencesobject[]

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.

previousobject

Valores antigos dos campos que mudaram entre email, first_name, last_name, unsubscribed e custom_fields. Omitido quando nenhum deles mudou.

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

Enviado quando um contato é excluído com Excluir um contato ou com a ação em massa delete. Antes, o Emailit envia 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.

Campos

event_idstring

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.

typestring

Sempre contact.deleted.

objectobject

O contato que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de contato

idstring

ID do contato (con_…).

objectstring

Sempre contact.

emailstring

Endereço de e-mail do contato, em minúsculas.

first_namestring | null

Nome.

last_namestring | null

Sobrenome.

custom_fieldsobject

Valores dos campos personalizados, indexados pelo campo. Consulte Campos personalizados.

unsubscribedboolean

Se o contato está descadastrado de todas as campanhas.

updated_atstring

Quando o contato foi atualizado pela última vez, em ISO 8601 com deslocamento UTC.

created_atstring

Quando o contato foi criado.

audiencesobject[]

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.

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

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.