Crear webhook

POST 
/webhooks

Registra un webhook activo para la empresa del usuario autenticado. Máximo 5 webhooks por empresa (cuentan los activos y los inactivos; los eliminados no). El servidor genera un secret que NO se incluye en esta respuesta: para obtener un secret con el que verificar la firma, llame a POST /webhooks/{id}/rotate-secret después de crearlo.

Request

Responses

201

Webhook creado (sin secret). La respuesta de creación no incluye failure_count, last_triggered_at ni deleted_at; consulte GET /webhooks/{id} para obtenerlos.

401

No autenticado

403

La empresa del usuario está inactiva

404

El usuario no tiene una empresa asociada

422

Datos inválidos (message "Los datos proporcionados no son válidos.") o límite de webhooks alcanzado (message "Error de validación de datos.", errors.url = ["Se ha alcanzado el límite de 5 webhooks por compañía."], un array con un mensaje; el límite cuenta los webhooks activos e inactivos, no los eliminados). Los eventos no válidos se reportan por índice (errors["events.N"] = ["Uno o más tipos de evento no son válidos."]); un events vacío o ausente devuelve errors.events = ["Debe seleccionar al menos un tipo de evento."]. Un elemento nulo en events devuelve errors["events.N"] = ["El campo events.N es obligatorio."]; un elemento que no es texto devuelve dos mensajes ("El campo events.N debe ser una cadena de caracteres." y "Uno o más tipos de evento no son válidos."); si events no es un array, errors.events = ["El campo events debe ser un array."].

429

Límite general de 60 peticiones por minuto excedido.