Create a webhook

Create a new webhook subscription. If this is the first webhook for this AI Agent, the webhook infrastructure is automatically provisioned

AuthorizationBearer

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

This endpoint expects an object.

urlstringRequiredformat: "uri"

The URL that will receive webhook events

descriptionstringOptionalDefaults to

A description of the webhook

event_filterslist of stringsOptional

Event types to subscribe to. An empty list subscribes to all events

enabledbooleanOptionalDefaults to true

Whether the webhook is enabled

Webhook created

idstring or nullRead-only

The webhook ID

urlstring or nullformat: "uri"

The URL that will receive webhook events

descriptionstring or null

A description of the webhook

event_filterslist of strings or null

Event types this webhook is subscribed to. If empty, the webhook receives all events

enabledboolean or null

Whether the webhook is enabled

created_atstring or nullRead-onlyformat: "date-time"

When the webhook was created

updated_atstring or nullRead-onlyformat: "date-time"

When the webhook was last updated

1	import requests
2
3	url = "https://example.ada.support/api/v2/webhooks/"
4
5	payload = { "url": "https://example.com/webhooks" }
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"id": "ep_2bxE8VNtkWEMpJrMJv74FlSQmqP",
3	"url": "https://example.com/webhooks",
4	"description": "My production webhook",
5	"event_filters": [
6	"v1.conversation.created",
7	"v1.conversation.ended"
8	],
9	"enabled": true,
10	"created_at": "2026-03-12T10:00:00+00:00",
11	"updated_at": "2026-03-12T10:00:00+00:00"
12	}