ByDomuDevelopers
Crear clave

Listar webhooks

GEThttps://api.bydomu.com/v1/webhooks

Webhooks de la organización con su última entrega y las fallidas de las últimas 24 h. El secreto nunca se devuelve. Pide el scope webhooks:write: la lista dice a dónde salen los datos de la organización.

Permiso
webhooks:write
Claves
Solo secreta (desde un servidor)

Encabezados

X-API-Keystringobligatorio
Tu clave secreta.

Respuestas

200Webhooks
401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.
403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.
429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.
500INTERNAL_ERROR · Error interno del servidor.
cURL
curl "https://api.bydomu.com/v1/webhooks" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/webhooks", {
  headers: { "X-API-Key": process.env.BYDOMU_API_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api.bydomu.com/v1/webhooks",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Respuesta · 200 · ejemplo
{
  "data": [
    {
      "id": "clx1whk001",
      "url": "https://hooks.zapier.com/hooks/catch/123456/abcdef/",
      "events": [],
      "eventTypes": [
        "deal.won"
      ],
      "isActive": true,
      "description": "Zap: negocios ganados a Google Sheets",
      "createdAt": "2026-09-22T12:00:00.000Z",
      "createdBy": {
        "id": "clx1usr001",
        "name": "Carlos Rodríguez"
      },
      "_count": {
        "deliveries": 42
      },
      "lastDelivery": {
        "success": true,
        "statusCode": 200,
        "error": "connect ETIMEDOUT",
        "createdAt": "2026-09-25T10:00:00.000Z"
      },
      "failedLast24h": 0
    }
  ]
}

La clave va en la variable BYDOMU_API_KEY. Los datos del ejemplo no son de ninguna inmobiliaria.