POST /v2/webhooks

Creates a new webhook to receive call event notifications.

The webhook secret is returned only once during creation and should be saved securely.

Request

Base URL
https://api.samora.ai
Auth
API key in header X-API-Key
TypeScript
https://skmtc.dev/i-stem/apis/samora-ai-api/docs/v2/webhooks/post.ts
A function with typed inputs. Its response is checked against the schema.

agent_idstring uuid required

The UUID of the agent this webhook is associated with.

namestring required

A friendly name for this webhook.

urlstring uri required

The HTTPS URL where webhook payloads will be sent.

eventsstring[] required

List of event types to subscribe to.

custom_headersCustomHeaders

Custom HTTP headers to send with webhook requests.

Webhook created successfully

messagestring required

Apr 10, 20268d556733b51c Revision changes
- info
  endpoint added
Feb 3, 2026919eb7a392aa Revision changes
- breaking
  api path removed without deprecation