Registrar Webhook

Registra una nueva URL de webhook para recibir notificaciones de eventos (envíos, DLR, respuestas).

post/webhook/add

Authorizations

apikeystringheaderrequired

Body

application/json

urlstringrequired· uri

URL del webhook (debe ser HTTPS válida)

statusenumrequired

Estado del webhook: '0'=deshabilitado, '1'=habilitado

enum:01

Response

200Webhook registrado exitosamente

successboolean

messagestring

Mensaje de estado

statusinteger

codestring

Código de respuesta

400Error de validación. Códigos posibles: `webhook_400` (URL inválida), `webhook_401` (límite de webhooks excedido).

successboolean

Siempre `false` para respuestas de error

messagestring

Descripción del error en español

statusinteger

Código HTTP de la respuesta

codestring

Código de error estructurado (`{dominio}_{número}`). Identifica de forma única la causa del error para manejo programático.

401No autorizado — API Key no provista, inválida o expirada

successboolean

Siempre `false`

messagestring

Descripción del error de autenticación en español

statusinteger

Código HTTP

codestring

Código de error de autenticación (`auth_01`, `auth_05`, `auth_06`, `auth_07`, `auth_99`)

403Prohibido — La dirección IP no está autorizada para acceder (IP whitelist)

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error: `auth_04` (IP no autorizada en whitelist)

429Demasiadas peticiones — Límite de rate limit excedido (100 mensajes/segundo producción, 100/día sandbox)

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error de rate limit

500Error interno del servidor

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error interno

request_idstring· uuid

Identificador único de la petición. Inclúyelo al contactar a soporte.