Create a webhook endpoint
Registers a URL that receives the event types in `events` (empty means all). The response carries the signing `secret` (`whsec_...`) once; store it to verify deliveries.
Registers a URL that receives the event types in events (empty means all). The response carries the signing secret (whsec_...) once; store it to verify deliveries.
X-API-Key<token>Create in the console: Settings → API & webhooks.
Idempotency-Key?stringAny unique string up to 255 characters. A concurrent duplicate gets 409 idempotency_request_in_progress. The success body holds a secret, so it is never stored: retrying a completed request with the same key returns 409 idempotency_key_reused instead of acting twice.
length <= 255application/json- body
description?DescriptionLabel shown in the console.
length <= 500""enabled?EnabledSet false to create the endpoint without sending to it yet.
trueevents?array<string>Event types to receive (see GET /webhook-event-types). Empty means every event type.
items <= 50url*UrlPublic https:// URL that receives events.
1 <= length <= 2048OK
application/json- response
secret*SecretSigning secret (whsec_...). Shown only in this response; store it securely.
success?SuccessAlways true on a 2xx response.
truewebhookEndpoint*[key: string]?anycurl -X POST 'https://api.callmitra.ai/api/v1/webhook-endpoints/' \ -H 'Content-Type: application/json' \ -d '{ "description": "CRM sync", "events": [ "call.completed", "call.escalated", "lead.created" ], "url": "https://example.com/hooks/call-mitra"}'{ "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw", "success": true, "webhookEndpoint": { "consecutiveFailures": 0, "createdAt": "2026-11-01T08:15:00+00:00", "description": "CRM sync", "enabled": true, "events": [ "call.completed", "call.escalated", "lead.created" ], "id": "4f0c2a8e-7b1d-4c39-9a51-2d6e8f3b1c07", "lastStatus": "HTTP 200", "lastSuccessAt": "2026-11-15T10:42:07.512000+00:00", "updatedAt": "2026-11-15T10:42:07.512000+00:00", "url": "https://example.com/hooks/call-mitra" }}