Update Webhook Subscription

Update the enabled events on a webhook subscription.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

The ID of the webhook subscription to update.

Example: "whes_Xj8mK2pL9nR4vT7qY5wZ"

Headers

x-extend-api-version"2026-02-09"Optional

API version to use for the request. If you’re using an SDK, you can ignore this parameter. If you are not using an SDK and do not specify a version, you will either receive a 400 Bad Request or be set to a previous legacy version. See API Versioning for more details.

API version to use for the request. If you're using an SDK, you can ignore this parameter. If you are not using an SDK and do not specify a version, you will either receive a `400 Bad Request` or be set to a previous legacy version. See [API Versioning](https://docs.extend.ai/2026-02-09/developers/api-versioning) for more details.

x-extend-workspace-idstringOptional

The workspace ID to target. Required when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See Authentication for details on API key scopes.

The workspace ID to target. **Required** when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See [Authentication](https://docs.extend.ai/2026-02-09/developers/authentication) for details on API key scopes.

Request

This endpoint expects an object.

enabledEventslist of enumsRequired

The event types to subscribe to. Must be valid for the subscription's resource type.

Response

Successfully updated webhook subscription

objectenum

Allowed values:

idstring

Unique identifier for the webhook subscription.

webhookEndpointIdstring

The ID of the webhook endpoint this subscription belongs to.

resourceTypeenum

The type of resource the webhook subscription is for.

Allowed values:

resourceIdstring

The ID of the resource this subscription is scoped to (e.g., an extractor, classifier, splitter, or workflow).

enabledEventslist of enums

The list of event types this subscription is subscribed to. The valid event types depend on the resourceType.

createdAtstringformat: "date-time"

The date and time the webhook subscription was created.

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

1	import { ExtendClient } from "extend-ai";
2
3	const client = new ExtendClient({ token: "YOUR_TOKEN" });
4	await client.webhookSubscriptions.update("webhook_subscription_id_here", {
5	enabledEvents: ["extract_run.processed"]
6	});

1	{
2	"object": "webhook_subscription",
3	"id": "whes_Xj8mK2pL9nR4vT7qY5wZ",
4	"webhookEndpointId": "wh_Xj8mK2pL9nR4vT7qY5wZ",
5	"resourceType": "extractor",
6	"resourceId": "ex_Xj8mK2pL9nR4vT7qY5wZ",
7	"enabledEvents": [
8	"extract_run.processed",
9	"extract_run.failed"
10	],
11	"createdAt": "2024-01-15T09:30:00Z"
12	}