GET /v1/webhooks

GET/v1/webhooks

Para desarrolladores

Descripción

Lista los webhooks de la instancia, con el estado de su última entrega. El secreto de firma no se incluye: solo se entrega al crear el webhook y al rotar su secreto.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope webhooks:read. Formato: Bearer FD.<key_id>.<token>.

X-Instance-Slugstringheaderobligatorio

Request

Query params:

pageinteger

Página, 1-indexed. Default: 1.

page_sizeinteger

Tamaño de página, 1–100. Default: 20.

Response

200 OK

Cada elemento de data:

idintegerobligatorio

Identificador del webhook.

namestringobligatorio

—

urlstringobligatorio

Endpoint que recibe las entregas.

eventsstring[] | nullobligatorio

Tipos de evento que recibe. null recibe todos. Ver Eventos *(pendiente de publicación)*.

is_activebooleanobligatorio

false si el webhook está pausado.

last_success_atstring (date-time) | nullobligatorio

Última entrega respondida con 2xx.

last_failure_atstring (date-time) | nullobligatorio

Última entrega fallida.

last_status_codeinteger | nullobligatorio

Código HTTP de la última entrega. null si no hubo respuesta, por timeout o error de conexión.

consecutive_failuresintegerobligatorio

Entregas fallidas seguidas desde el último éxito.

auto_paused_atstring (date-time) | nullobligatorio

Momento en que el webhook se pausó por fallos persistentes. null si no está pausado automáticamente.

previous_secret_expires_atstring (date-time) | nullobligatorio

Hasta cuándo el secreto anterior a la última rotación firma junto al vigente. null si no hay un secreto anterior vigente.

created_atstring (date-time)obligatorio

—

updated_atstring (date-time)obligatorio

Última modificación de la configuración del webhook. Una entrega no la cambia.

Notas

• Los webhooks se devuelven en orden de creación.
• consecutive_failures mayor que cero indica un endpoint que está fallando. Qué cuenta como fallo y cómo se reintenta está en Respuesta y reintentos (pendiente de publicación).
• Un webhook con auto_paused_at informado se pausó por fallos persistentes y no recibe entregas hasta reactivarlo. Ver Pausa automática (pendiente de publicación).

Request

curl -X GET "https://$API_HOST/v1/webhooks" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

{
"data": [
  {
    "id": 3,
    "name": "CRM de ventas",
    "url": "https://hooks.example.com/fidelizador",
    "events": [
      "mail.sent",
      "mail.bounced"
    ],
    "is_active": true,
    "last_success_at": "2026-09-13T12:00:04Z",
    "last_failure_at": null,
    "last_status_code": 200,
    "consecutive_failures": 0,
    "auto_paused_at": null,
    "previous_secret_expires_at": null,
    "created_at": "2026-09-10T15:30:00Z",
    "updated_at": "2026-09-10T15:30:00Z"
  }
],
"pagination": {
  "page": 1,
  "page_size": 20,
  "has_more": false,
  "total_items": 1,
  "total_pages": 1
}
}