For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.

- Welcome
API Reference

API Reference Webhooks

Crear Webhook

POST

https://nebrijaai.com/api/v1/webhooks

POST

/api/v1/webhooks

$ curl -X POST https://nebrijaai.com/api/v1/webhooks \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "url": "https://myapp.com/webhooks/call-events",
>   "events": [
>     "call.started",
>     "call.finished"
>   ]
> }'

200Successful

1 {
2   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3   "url": "https://myapp.com/webhooks/call-events",
4   "events": [
5     "call.started",
6     "call.finished"
7   ],
8   "description": "Webhook para eventos de llamadas",
9   "secret": "whsec_9f8b7c6d5e4a3b2c1d0e9f8a7b6c5d4e",
10   "createdAt": "2024-01-15T09:30:00Z"
11 }

Registra un nuevo endpoint para recibir eventos. Al crear el webhook se genera automáticamente un secreto de firma HMAC (whsec_...). Los eventos disponibles son: call.started, call.finished, call.failed.

Was this page helpful?

Obtener Webhook

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

urlstringRequiredformat: "uri"

URL pública que recibirá los eventos.

eventslist of stringsRequired

Eventos a escuchar. Ejemplo: call.started, call.finished, call.failed

descriptionstringOptional

Response

Webhook creado (incluye el secreto de firma).

idstringformat: "uuid"

urlstring

eventslist of strings

Ejemplo: call.finished, call.started

descriptionstring

secretstring

Secreto de firma HMAC (formato: whsec_…). Solo visible en la creación.

createdAtdatetime