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
POSThttps://g.sendcorex.com/v1/feedbackfeedback:read

Có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. 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. 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. 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"
}
kind

bounce_hard, bounce_soft, blocked, complaint o dropped. Solo los hard bounces y las quejas significan "deja de enviar a esta dirección".

source

De dónde vino: la respuesta SMTP, un mensaje de bounce posterior, un feedback loop o un reporte de abuso.

smtp_code / enhanced_code

El código que respondió el servidor, como 550 y 5.1.1. diagnostic tiene el texto completo.

email_id

El 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.

Polling

Detecta 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 tipo

Explica 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 Email

Recí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.

Webhooks

Referencia completa

Todo lo marcado como CMD es un comando enviado a través de POST /v1/feedback, hasta 20 por solicitud.