Crear un webhook
Crea un nuevo endpoint de webhook para recibir notificaciones de eventos en tiempo real.
Parámetros
Cuerpo de la solicitud
name
string
Obligatorio
Nombre descriptivo para el endpoint del webhook
url
string
Obligatorio
URL HTTPS que recibirá las solicitudes POST del webhook
event_types
array
Obligatorio
Eventos a los que suscribirse (use "all" para todos los eventos)
description
string
Descripción opcional como referencia
is_active
boolean
Si el webhook está activo
retry_attempts
integer
Número de reintentos en caso de fallo (0-10)
timeout
integer
Tiempo de espera de la solicitud en segundos (5-60)
auth_type
string (none | basic | bearer | custom)
Método de autenticación para su endpoint
auth_config
object
Credenciales de autenticación (dependen de auth_type)
custom_headers
object
Encabezados HTTP adicionales a incluir en las solicitudes
Devuelve
201
Webhook creado correctamente
400
Error de validación
401
Autenticación requerida
Relacionado
Webhooks
POST/api/v1/webhooks