Create a webhook subscription | Dial — Communication Stack for AI Agents

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

This endpoint expects an object.

targetUrlstringRequiredformat: "uri"

HTTPS only; not a private/loopback host.

eventTypeslist of enumsRequired

The created subscription. The full signing secret is included once here.

webhookobject

400

Bad Request Error

401

Unauthorized Error

$	curl -X POST https://api.getdial.ai/api/v1/webhooks \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"targetUrl": "https://webhooks.example.com/receive",
>	"eventTypes": [
>	"message.received"
>	]
>	}'

1	{
2	"webhook": {
3	"id": "wh_9f8b7c6d5e4a3b2c1d0e",
4	"targetUrl": "https://webhooks.example.com/receive",
5	"eventTypes": [
6	"message.received"
7	],
8	"secretMasked": "whsec_••••••••ab12",
9	"lastPingSucceededAt": "2024-01-15T09:30:00Z",
10	"createdAt": "2024-01-15T09:30:00Z"
11	}
12	}