Bounces & Complaints

Saiba quais emails não chegaram, e por quê

Hard e soft bounces, bloqueios, reclamações de spam e denúncias de abuso em um único feed. Consulte com um cursor, limpe suas listas e nunca perca um evento.

  • Comandos JSON
  • Polling com cursor
  • Até 1000 por chamada
  • Últimos 90 dias
  • Somente leitura
POSThttps://g.sendcorex.com/v1/feedbackfeedback:read

Como funciona

Tudo o que voltou

Bounces no momento do envio, mensagens de bounce que chegam depois, feedback loops da Microsoft e do Yahoo e as denúncias de abuso que as pessoas nos enviam. Um feed, um formato.

Hard, soft ou bloqueado

Nem todo 5xx é um endereço ruim. Cada evento diz se o endereço não existe mais (hard), se foi temporário (soft) ou se a própria mensagem foi recusada (blocked).

Feito para polling

Do mais antigo para o mais novo, com um cursor que sempre volta. Guarde-o, envie de novo e você recebe exatamente o que é novo. Um evento por email, nunca duas vezes.

Primeiros passos

Só a key é necessária antes da sua primeira requisição.

  1. 1

    Crie uma API key com feedback:read

    No dashboard, abra Developers → API Keys e crie uma key com o escopo feedback:read, ou adicione-o a uma key que você já usa.

    O token do webmail não funciona aqui. Esta API usa a API key do dashboard.

  2. 2

    Consulte o feed

    List Feedback retorna o que há de novo desde o seu cursor. Guarde o next_cursor que ele devolve e envie-o na próxima chamada.

  3. 3

    Consulte um email

    Get Email mostra tudo o que voltou para um id de email: o bounce, a reclamação ou por que ele não foi enviado.

O evento

Os dois comandos retornam eventos neste formato.

{
  "email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
  "kind": "bounce_hard",
  "source": "smtp",
  "recipient": "old.address@gmail.com",
  "from": "noreply@yourdomain.com",
  "smtp_code": 550,
  "enhanced_code": "5.1.1",
  "diagnostic": "550-5.1.1 The email account that you tried to reach does not exist.",
  "at": "2026-10-17T05:58:44.031Z"
}
kind

bounce_hard, bounce_soft, blocked, complaint ou dropped. Só hard bounces e reclamações significam "pare de enviar para este endereço".

source

De onde veio: a resposta SMTP, uma mensagem de bounce posterior, um feedback loop ou uma denúncia de abuso.

smtp_code / enhanced_code

O código que o servidor respondeu, como 550 e 5.1.1. diagnostic tem o texto completo.

email_id

O mesmo id dos Logs e dos webhooks, para você poder cruzá-los.

Sua primeira requisição

Seus hard bounces e reclamações desde o início do mês. Substitua SENDCOREX_API_KEY pela sua API key.

curl -X POST 'https://g.sendcorex.com/v1/feedback' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_feedback", "args": { "since": "2026-10-01T00:00:00Z", "kinds": ["bounce_hard", "complaint"] } }
  ]
}'

Você recebe os eventos do mais antigo para o mais novo e um next_cursor. Guarde-o e envie na próxima chamada para receber só o que é novo. A mesma requisição em 8 linguagens está em List Feedback.

Tarefas comuns

Mantenha suas listas limpas

Consulte a cada 30 segundos e remova os endereços com hard bounce ou reclamação. Sua reputação continua alta e seus envios ficam fora do spam.

Polling

Detecte reclamações rápido

Filtre o feed por complaint e avise seu time: um pico de reclamações é o primeiro sinal de que uma campanha está dando errado.

Filtrando por tipo

Explique um email que não chegou

A partir de um id de email, mostre ao seu cliente o motivo exato que o servidor de destino deu.

Get Email

Receba por push

Os webhooks bounced e fbl_complaint enviam os mesmos eventos no momento em que acontecem. Use o polling como rede de segurança.

Webhooks

Referência completa

Tudo marcado como CMD é um comando enviado por POST /v1/feedback, até 20 por requisição.