Webhooks

Listar entregas

Obtiene los intentos de entrega de un endpoint de webhook, paginados. Filtra por estado para separar las entregas exitosas de las fallidas o pendientes.

GEThttps://graph.sendcorex.com/v3.0/webhooks/:id/deliveries

Parámetros

  • idstringobligatorio

    Parámetro de ruta. ID del endpoint de webhook.

    p. ej. "wh_123"

  • statusstringopcional

    Parámetro de query. delivered o failed (failed incluye las pendientes). Omítelo para ver todas.

    p. ej. "failed"

  • pagenumberopcional

    Parámetro de query. Número de página. Por defecto 1.

    p. ej. 1

  • limitnumberopcional

    Parámetro de query. Resultados por página. Por defecto 20, máximo 50.

    p. ej. 20

Inicio rápido

import axios from 'axios';

const response = await axios.get('https://graph.sendcorex.com/v3.0/webhooks/wh_123/deliveries?status=failed&page=1&limit=20', {
  headers: { Authorization: process.env.SENDCOREX_API_KEY },
});

console.log(response.data);

Respuesta

{
  "success": true,
  "deliveries": [
    {
      "id": "del_9f3a",
      "event": "bounced",
      "status": "failed",
      "httpStatus": 500,
      "responseBody": "Internal Server Error",
      "attemptNumber": 3,
      "nextRetryAt": null,
      "createdAt": "2026-08-08T14:22:00.000Z"
    }
  ],
  "total": 47,
  "page": 1,
  "limit": 20,
  "responseTime": "38ms"
}

Campos de la respuesta

  • deliveries[].id

    ID de la entrega. Pásalo a Reintentar entrega.

  • deliveries[].event

    El evento que se estaba entregando, por ejemplo bounced.

  • deliveries[].status

    Estado de la entrega, por ejemplo failed.

  • deliveries[].httpStatus

    Estado HTTP con el que respondió tu servidor.

  • deliveries[].responseBody

    Cuerpo con el que respondió tu servidor.

  • deliveries[].attemptNumber

    Cuántos intentos se hicieron.

  • deliveries[].nextRetryAt

    Cuándo está programado el próximo intento, o null.

  • deliveries[].createdAt

    Fecha y hora en ISO 8601.

  • total / page / limit

    Información de paginación.

Errores

Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.

  • 401INVALID_API_KEY

    La API key no es válida o fue revocada.