Registrar un endpoint de webhooks

post /v1/webhook_endpoints

Registra una URL para recibir eventos. La respuesta trae el secreto de firma una sola vez: guárdalo en ese momento.

Cada entrega va firmada. Verifica la firma antes de confiar en el cuerpo.

Autenticación

Requiere API key (sk_live_… · sk_test_…) en la cabecera authorization: Bearer …. Ver autenticación.

Cuerpo de la petición

url string obligatorio

events enum[] obligatorio

description string

Respuesta 201

Endpoint creado

id string obligatorio

url string obligatorio

events enum[] obligatorio

status enum obligatorio

activedisabled

secret string

created_at string obligatorio

curl -X POST https://api.klevy.cl/v1/webhook_endpoints \ -H 'authorization: Bearer sk_live_tu_api_key' \ -H 'content-type: application/json' \ -d '{ "url": "https://tu-sistema.cl/webhooks/klevy", "events": [ "run.completed", "run.failed" ] }'

const respuesta = await fetch( 'https://api.klevy.cl/v1/webhook_endpoints', { method: 'POST', headers: { authorization: 'Bearer sk_live_tu_api_key', 'content-type': 'application/json', }, body: JSON.stringify({ "url": "https://tu-sistema.cl/webhooks/klevy", "events": [ "run.completed", "run.failed" ] }), }, ); const datos = await respuesta.json();

import requests respuesta = requests.post( "https://api.klevy.cl/v1/webhook_endpoints", headers={ "authorization": "Bearer sk_live_tu_api_key", }, json={ "url": "https://tu-sistema.cl/webhooks/klevy", "events": [ "run.completed", "run.failed" ] }, ) datos = respuesta.json()