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
https://g.sendcorex.com/v1/feedbackfeedback:readComo 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
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
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
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"
}kindbounce_hard, bounce_soft, blocked, complaint ou dropped. Só hard bounces e reclamações significam "pare de enviar para este endereço".
sourceDe onde veio: a resposta SMTP, uma mensagem de bounce posterior, um feedback loop ou uma denúncia de abuso.
smtp_code / enhanced_codeO código que o servidor respondeu, como 550 e 5.1.1. diagnostic tem o texto completo.
email_idO 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.
PollingDetecte 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 tipoExplique 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 EmailReceba 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.
WebhooksReferência completa
Tudo marcado como CMD é um comando enviado por POST /v1/feedback, até 20 por requisição.