Create a webhook

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

Authentication

AuthorizationBearer

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

Request

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

Response

Webhook created

idstringRead-only

The webhook ID

urlstringformat: "uri"

The URL that will receive webhook events

descriptionstring

A description of the webhook

event_filterslist of strings

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

enabledboolean

Whether the webhook is enabled

created_atstringRead-onlyformat: "date-time"

When the webhook was created

updated_atstringRead-onlyformat: "date-time"

When the webhook was last updated

Errors

400

Bad Request Error

401

Unauthorized Error

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

This endpoint expects an object.

The URL that will receive webhook events

A description of the webhook

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

Whether the webhook is enabled

The URL that will receive webhook events

A description of the webhook

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

Whether the webhook is enabled

When the webhook was created

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	}

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	}