# Eventos de inscrito > Contatos adicionados a uma lista de contatos, alterados nela, adicionados de novo a ela ou removidos dela. ## subscriber.created > Enviado quando um contato é adicionado a uma lista de contatos, pela API, pelo painel ou ao criar um contato com listas. # subscriber.created Enviado quando um contato é adicionado a uma lista de contatos com [Adicionar um inscrito](/pt/docs/api-reference/audiences/subscribers/add/), ou quando você cria ou atualiza um contato com `audiences`. Adicionar um contato que tinha se descadastrado da lista envia [`subscriber.updated`](/pt/docs/webhooks/events/subscriber/updated/) e [`subscriber.resubscribed`](/pt/docs/webhooks/events/subscriber/resubscribed/) em vez deste evento. 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": "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" } } } ``` ## 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 `subscriber.created`. - `object` (object): O inscrito 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 inscrito - `id` (string): ID do inscrito (`sub_…`). Um inscrito é a participação de um contato em uma lista de contatos. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Se o contato está inscrito na lista. - `subscribed_at` (string | null): Quando o contato se inscreveu, ou `null`. - `unsubscribed_at` (string | null): Quando o contato se descadastrou, ou `null`. - `audience` (object): `id` e `name` da lista de contatos. - `contact` (object): O contato: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `created_at` (string): Quando o contato foi adicionado à lista, em ISO 8601 com deslocamento UTC. --- Fonte: https://emailit.com/pt/docs/webhooks/events/subscriber/subscriber-created/ ## subscriber.updated > Enviado quando um inscrito muda, inclusive quando o contato se descadastra de uma lista de contatos ou volta a ela. # subscriber.updated Enviado quando um inscrito muda: você o atualiza com [Atualizar um inscrito](/pt/docs/api-reference/audiences/subscribers/update/), o contato se descadastra ou se reinscreve, ou um contato que tinha se descadastrado é adicionado de novo à lista. Quando a mudança vem de um descadastro ou de uma reinscrição, `previous` contém os valores antigos. 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": "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 } } } } ``` ## 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 `subscriber.updated`. - `object` (object): O inscrito 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 inscrito - `id` (string): ID do inscrito (`sub_…`). Um inscrito é a participação de um contato em uma lista de contatos. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Se o contato está inscrito na lista. - `subscribed_at` (string | null): Quando o contato se inscreveu, ou `null`. - `unsubscribed_at` (string | null): Quando o contato se descadastrou, ou `null`. - `audience` (object): `id` e `name` da lista de contatos. - `contact` (object): O contato: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `updated_at` (string): Quando o inscrito foi atualizado pela última vez, em ISO 8601 com deslocamento UTC. - `created_at` (string): Quando o contato foi adicionado à lista. - `previous` (object): Valores antigos, incluídos quando o contato se descadastrou ou se reinscreveu: `subscribed` e `unsubscribed_at`. Omitido nas outras mudanças. --- Fonte: https://emailit.com/pt/docs/webhooks/events/subscriber/subscriber-updated/ ## subscriber.resubscribed > Enviado quando você adiciona de volta um contato a uma lista de contatos da qual ele tinha se descadastrado. Não faz parte da lista de eventos do painel. # subscriber.resubscribed Enviado quando você adiciona um contato a uma lista de contatos da qual ele tinha se descadastrado, com [Adicionar um inscrito](/pt/docs/api-reference/audiences/subscribers/add/). O Emailit também envia [`subscriber.updated`](/pt/docs/webhooks/events/subscriber/updated/) com o mesmo inscrito. `subscriber.resubscribed` não está na lista de eventos do painel. Você o recebe nos webhooks que têm `all_events` ativado ou adicionando-o a `events` com [Atualizar um webhook](/pt/docs/api-reference/webhooks/update/). 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": "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 } } } ``` ## 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 `subscriber.resubscribed`. - `object` (object): O inscrito 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 inscrito - `id` (string): ID do inscrito (`sub_…`). Um inscrito é a participação de um contato em uma lista de contatos. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Se o contato está inscrito na lista. - `subscribed_at` (string | null): Quando o contato se inscreveu, ou `null`. - `unsubscribed_at` (string | null): Quando o contato se descadastrou, ou `null`. - `audience` (object): `id` e `name` da lista de contatos. - `contact` (object): O contato: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `updated_at` (string): Quando o inscrito foi atualizado pela última vez, em ISO 8601 com deslocamento UTC. - `created_at` (string): Quando o contato foi adicionado à lista. - `resubscribed` (boolean): Sempre `true`. --- Fonte: https://emailit.com/pt/docs/webhooks/events/subscriber/subscriber-resubscribed/ ## subscriber.deleted > Enviado quando um contato é removido de uma lista de contatos, inclusive quando o próprio contato é excluído. # subscriber.deleted Enviado quando um contato é removido de uma lista de contatos: com [Excluir um inscrito](/pt/docs/api-reference/audiences/subscribers/delete/), quando você altera as `audiences` de um contato ou quando você exclui o contato. O payload é o inscrito como era antes da remoção. 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": "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" } } } ``` ## 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 `subscriber.deleted`. - `object` (object): O inscrito 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 inscrito - `id` (string): ID do inscrito (`sub_…`). Um inscrito é a participação de um contato em uma lista de contatos. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Se o contato está inscrito na lista. - `subscribed_at` (string | null): Quando o contato se inscreveu, ou `null`. - `unsubscribed_at` (string | null): Quando o contato se descadastrou, ou `null`. - `audience` (object): `id` e `name` da lista de contatos. - `contact` (object): O contato: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `updated_at` (string): Quando o inscrito foi atualizado pela última vez, em ISO 8601 com deslocamento UTC. - `created_at` (string): Quando o contato foi adicionado à lista. --- Fonte: https://emailit.com/pt/docs/webhooks/events/subscriber/subscriber-deleted/