API REST: changelog

O servidor MCP em https://api.emailit.com/mcp agora cobre tudo o que está na API v2:

• Novos toolsets: campanhas, automações, formulários, relatórios DMARC, verificação de e-mails, eventos, ações em massa e exportação de contatos, inscritos, e testes, novas tentativas e rotação do segredo de webhooks. Consulte a referência de ferramentas.
• Anotações: cada ferramenta é marcada como somente leitura, destrutiva, idempotente ou com acesso ao mundo externo, para que os clientes peçam confirmação antes de executar ações de escrita.
• Resultados estruturados: as ferramentas retornam JSON como texto e como conteúdo estruturado para os clientes que o interpretam.
• Instruções embutidas: o servidor orienta os assistentes a confirmar os destinatários antes de enviar e a perguntar antes de excluir qualquer coisa.
• Toolsets e modo somente leitura: carregue menos ferramentas com ?toolsets= ou oculte as ferramentas de escrita com ?read_only=true. Consulte Toolsets.
• Transporte sem estado: não há sessões MCP para expirar; os clientes enviam todas as requisições com POST.

Corrigido: as conexões OAuth aprovadas com os escopos sending e full agora funcionam em todas as ferramentas, e o workspace para o qual você muda continua selecionado depois que o cliente atualiza o token.

• As chaves de API criadas antes de as chaves terem o prefixo secret_ voltam a ser aceitas na /v2.
• Obter um e-mail retorna o objeto de e-mail completo, incluindo object, from e to.
• As respostas de domínios retornam track_loads e track_clicks como 0 ou 1, como documentado.

Abra Email API → Logs para ver as requisições bem-sucedidas e com falha, da última hora até os últimos 30 dias. Filtre por origem (API ou SMTP), resultado, método, caminho, código de status, duração ou chave de API e abra uma requisição para ver os corpos da requisição e da resposta. Os valores sensíveis são ocultados, e os corpos longos são encurtados.

Consulte Logs de requisições.

No painel, use Filters para combinar condições com Match all ou Match any, clique nos cabeçalhos das colunas para ordenar e escolha as colunas em Display options.

Na API, filtre com parâmetros de consulta field.condition=value, combine-os com match=all ou match=or e ordene com order e direction:

curl "https://api.emailit.com/v2/emails?status.exact=bounced&created_at.after=2026-09-01&order=created_at&direction=desc" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Cada endpoint de listagem documenta os campos que podem ser filtrados. Consulte Filtragem.

• Contatos: crie, liste, consulte, atualize e exclua contatos. Encontre um contato pelo ID con_ ou pelo endereço de e-mail e adicione-o a listas de contatos na mesma chamada.
• Eventos: liste eventos, filtrados por um ou mais tipos e, se quiser, com os dados deles, e consulte um único evento.
• Webhooks: crie, liste, consulte, atualize e exclua endpoints de webhook.

Esses endpoints exigem uma chave de acesso total. Consulte a referência da API.

Os IDs são únicos entre os serviços e ficam em ordem de criação. Os prefixos mais comuns são em_ para e-mails, dom_ para domínios, key_ para chaves de API, aud_ para listas de contatos, sub_ para inscritos, con_ para contatos, sup_ para supressões, wh_ para webhooks, evt_ para eventos e cmp_ para campanhas.

Guarde os IDs como strings opacas em vez de interpretá-los.

Os novos recursos só chegam à API v2, em https://api.emailit.com/v2. Se você ainda chama /v1, passe para os endpoints da v2 e envie a sua chave de API no cabeçalho Authorization: Bearer.

Consulte Versionamento.

As chaves de API substituem as credenciais. Uma chave tem o escopo full ou sending, uma chave de envio pode ser restrita a um único domínio de envio, e você pode gerenciar as chaves pela API. A API v1 continuou disponível durante a sua migração.

Consulte a referência da API.