Register a new webhook endpoint | Voicebip

Adds a fan-out destination to the agent. The endpoint is active immediately — the consumer will deliver to it on the next matching event. All URLs are validated for SSRF safety (must be HTTPS, non-RFC1918, non-link-local).

Authentication

AuthorizationBearer

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

Path parameters

agent_idstringRequired

Request

This endpoint expects an object.

urlstringRequired

HTTPS endpoint URL. Must be publicly reachable and non-RFC1918.

descriptionstringOptional

Optional label shown in the dashboard

Response

Endpoint created

idstring

ID of the newly created endpoint (whep_ prefix)

Errors

400

Create Webhook Endpoint Request Bad Request Error

401

Create Webhook Endpoint Request Unauthorized Error

$	curl -X POST https://api.voicebip.com/v1/agents/agent_id/webhooks/endpoints \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"url": "https://your-server.example.com/webhooks"
>	}'