Bounces & Complaints
Sabe qué emails no llegaron, y por qué
Hard y soft bounces, bloqueos, quejas de spam y reportes de abuso en un solo feed. Consúltalo con un cursor, limpia tus listas y no pierdas ningún evento.
- Comandos JSON
- Polling con cursor
- Hasta 1000 por llamada
- Últimos 90 días
- Solo lectura
https://g.sendcorex.com/v1/feedbackfeedback:readCómo funciona
Todo lo que volvió
Bounces en el momento del envío, mensajes de bounce que llegan más tarde, feedback loops de Microsoft y Yahoo, y los reportes de abuso que nos envía la gente. Un feed, una estructura.
Hard, soft o bloqueado
No todo 5xx es una dirección mala. Cada evento indica si la dirección ya no existe (hard), si fue temporal (soft) o si se rechazó el propio mensaje (blocked).
Hecho para polling
Del más antiguo al más reciente, con un cursor que siempre vuelve. Guárdalo, envíalo de nuevo y obtienes exactamente lo nuevo. Un evento por email, nunca dos veces.
Primeros pasos
Solo necesitas la key antes de tu primera solicitud.
- 1
Crea una API key con feedback:read
En el dashboard, abre Developers → API Keys y crea una key con el scope feedback:read, o añádelo a una key que ya uses.
El token del webmail no funciona aquí. Esta API usa la API key del dashboard.
- 2
Consulta el feed
List Feedback devuelve lo nuevo desde tu cursor. Guarda el next_cursor que te da y envíalo en la siguiente llamada.
- 3
Consulta un email
Get Email te dice todo lo que volvió para un id de email: su bounce, su queja o por qué no se envió.
El evento
Ambos comandos devuelven eventos con esta estructura.
{
"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 o dropped. Solo los hard bounces y las quejas significan "deja de enviar a esta dirección".
sourceDe dónde vino: la respuesta SMTP, un mensaje de bounce posterior, un feedback loop o un reporte de abuso.
smtp_code / enhanced_codeEl código que respondió el servidor, como 550 y 5.1.1. diagnostic tiene el texto completo.
email_idEl mismo id que en Logs y en los webhooks, para que puedas cruzarlos.
Tu primera solicitud
Tus hard bounces y quejas desde el inicio del mes. Reemplaza SENDCOREX_API_KEY por tu 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"] } }
]
}'Obtienes los eventos del más antiguo al más reciente y un next_cursor. Guárdalo y envíalo en la siguiente llamada para obtener solo lo nuevo. La misma solicitud en 8 lenguajes está en List Feedback.
Tareas comunes
Mantén tus listas limpias
Consulta cada 30 segundos y elimina las direcciones con hard bounce o queja. Tu reputación se mantiene alta y tus envíos no caen en spam.
PollingDetecta quejas rápido
Filtra el feed por complaint y avisa a tu equipo: un pico de quejas es la primera señal de que una campaña va mal.
Filtrar por tipoExplica un email que no llegó
A partir de un id de email, muestra a tu cliente el motivo exacto que dio el servidor de destino.
Get EmailRecíbelos por push
Los webhooks bounced y fbl_complaint envían los mismos eventos en el momento en que ocurren. Usa el polling como red de seguridad.
WebhooksReferencia completa
Todo lo marcado como CMD es un comando enviado a través de POST /v1/feedback, hasta 20 por solicitud.