Made in 10Docs
GuidesAPI
ReferenceWebhooks

Add a webhook endpoint

Adds an endpoint in this key's env and answers its signing secret, the only time it is shown besides a rotation.

POST
/webhooks

Authorization

secretKey
headerAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>

A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.

Request Body

application/json
  1. body
Example
{  "url": "https://example.com/hooks/calls",  "description": "our CRM",  "event_types": [    "call.ended",    "call.analyzed"  ]}
url*string

An https address, no #fragment, every address it resolves to public.

Formaturi
Lengthlength <= 2000
description?string
Lengthlength <= 500
Default""
event_types?array<>
Default[]
env?Env

Optional; only this key's own env is allowed (another is 400).

Value in"live""test"
enabled?boolean
Defaulttrue

Response Body

The endpoint and its secret. Keep the secret; it can't be read again.

application/json
  1. response
webhook*

An endpoint (never its secret).

Example
{  "id": "whe_6Tn1Vb8XcK3mPq9LsD2f",  "url": "https://example.com/hooks/calls",  "description": "our CRM",  "event_types": [],  "env": "live",  "enabled": true,  "disabled_reason": null,  "failing_since_unix": null,  "previous_secret_until_unix": null,  "created_unix": 1793300000,  "updated_unix": 1793300000}
secret*WebhookSecret

A signing secret: whsec_ and 32 random bytes in base64. Shown only when it is made.

Match^whsec_[A-Za-z0-9+/]{43}=$
Example"whsec_BwgJCgsMDQ4PEBESExQVFhcYGRobHB0eHyAhIiMkJSY="
Example Request
curl -X POST 'https://api.daxov.com/v1/webhooks' \  -H 'Content-Type: application/json' \  -d '{  "url": "https://example.com/hooks/calls",  "description": "our CRM",  "event_types": [    "call.ended",    "call.analyzed"  ]}'
Example Response
{  "webhook": {    "id": "whe_6Tn1Vb8XcK3mPq9LsD2f",    "url": "https://example.com/hooks/calls",    "description": "our CRM",    "event_types": [],    "env": "live",    "enabled": true,    "disabled_reason": null,    "failing_since_unix": null,    "previous_secret_until_unix": null,    "created_unix": 1793300000,    "updated_unix": 1793300000  },  "secret": "whsec_BwgJCgsMDQ4PEBESExQVFhcYGRobHB0eHyAhIiMkJSY="}