# Novos endpoints da API: contatos, eventos e webhooks

> Gerencie contatos, consulte eventos e configure webhooks de forma programática com as novidades da API do Emailit.

2026-02-17 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Acabamos de lançar três novos grupos de recursos na API v2 do Emailit: **contatos**, **eventos** e **webhooks**. Juntos, eles dão a você controle programático total sobre a sua base de contatos, o monitoramento de eventos e as integrações por webhook.

## Contatos

A API de contatos permite criar, consultar, atualizar e excluir contatos no seu workspace. Cada contato tem um endereço de e-mail, um nome e campos personalizados opcionais, e pode ser inscrito em uma ou mais listas em uma única chamada.

| Endpoint | Descrição |
| --- | --- |
| [Listar contatos](https://emailit.com/docs/api-reference/contacts/list) | Lista paginada de todos os contatos |
| [Obter contato](https://emailit.com/docs/api-reference/contacts/get) | Obter um contato pelo ID ou pelo e-mail |
| [Criar contato](https://emailit.com/docs/api-reference/contacts/create) | Criar um novo contato e inscrevê-lo em listas |
| [Atualizar contato](https://emailit.com/docs/api-reference/contacts/update) | Atualizar nome, e-mail, campos personalizados ou status de descadastro |
| [Excluir contato](https://emailit.com/docs/api-reference/contacts/delete) | Excluir um contato e todos os inscritos associados |

Os contatos podem ser consultados pelo ID (`con_xxx`) ou pelo endereço de e-mail, então você usa o identificador que for mais prático.

```json
{
  "email": "joao@exemplo.com",
  "first_name": "João",
  "last_name": "Silva",
  "custom_fields": { "company": "Acme" },
  "audiences": ["aud_2BxFg7KNqr5M..."]
}
```

## Eventos

Os eventos são criados automaticamente sempre que algo acontece no seu workspace: um e-mail é entregue, um contato é criado, um domínio é atualizado e assim por diante. A API de eventos oferece acesso somente leitura a esse fluxo de atividades.

| Endpoint | Descrição |
| --- | --- |
| [Listar eventos](https://emailit.com/docs/api-reference/events/list) | Lista paginada com filtro por tipo e payload de dados opcional |
| [Obter evento](https://emailit.com/docs/api-reference/events/get) | Obter um único evento com todos os dados |

Você pode filtrar por um ou mais tipos de evento com valores separados por vírgula e usar `include_data` para definir se o payload completo é retornado nas listagens.

```
GET /v2/events?type=email.accepted,email.delivered&include_data=true
```

## Webhooks

Os webhooks permitem receber callbacks HTTP em tempo real sempre que ocorrem eventos. A nova API de webhooks dá a você controle total: crie, atualize, ative/desative e exclua endpoints de webhook, tudo pela API.

| Endpoint | Descrição |
| --- | --- |
| [Listar webhooks](https://emailit.com/docs/api-reference/webhooks/list) | Lista paginada de todos os webhooks |
| [Obter webhook](https://emailit.com/docs/api-reference/webhooks/get) | Obter um webhook pelo ID |
| [Criar webhook](https://emailit.com/docs/api-reference/webhooks/create) | Criar um novo endpoint de webhook |
| [Atualizar webhook](https://emailit.com/docs/api-reference/webhooks/update) | Atualizar URL, eventos ou status de ativação |
| [Excluir webhook](https://emailit.com/docs/api-reference/webhooks/delete) | Excluir um webhook pelo ID ou pelo nome |

Você pode assinar tipos de evento específicos ou usar `all_events` para receber tudo.

```json
{
  "name": "Webhook de Produção",
  "url": "https://exemplo.com/webhook",
  "events": ["email.accepted", "email.delivered", "email.bounced"]
}
```

Há mais de 30 tipos de evento disponíveis, abrangendo e-mails, domínios, listas, inscritos, contatos, templates, supressões e verificações de e-mail. Veja a lista completa na documentação de [criação de webhook](https://emailit.com/docs/api-reference/webhooks/create).

## Comece agora

As três APIs exigem uma chave de API com acesso total. Acesse a [referência da API](https://emailit.com/docs/api-reference/endpoints) para explorar todos os novos endpoints ou vá direto para a documentação indicada acima.

---

Source: https://emailit.com/pt/blog/novos-endpoints-api-contatos-eventos-webhooks/
