Update a webhook

Update a webhook subscription. Only the fields provided in the request body will be updated

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

The webhook ID

Request

This endpoint expects an object.

urlstringOptionalformat: "uri"

The URL that will receive webhook events

descriptionstringOptional

A description of the webhook

event_filterslist of stringsOptional

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

enabledbooleanOptional

Whether the webhook is enabled

Response

Webhook updated

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

404

Not Found 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/id"
4
5	payload = {}
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.patch(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/id"
4
5	payload = {}
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.patch(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	}