Claude Platform Docs

Webhooks

Create Organization Webhook Endpoint
POST/v1/organizations/webhooks
Requires anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.

Create an organization webhook endpoint.

List Organization Webhook Endpoints
GET/v1/organizations/webhooks
Requires anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.

List the organization's webhook endpoints.

Get Organization Webhook Endpoint
GET/v1/organizations/webhooks/{webhook_endpoint_id}
Requires anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.

Retrieve an organization webhook endpoint by ID.

Update Organization Webhook Endpoint
POST/v1/organizations/webhooks/{webhook_endpoint_id}
Requires anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.

Update an organization webhook endpoint. Only the fields you send are changed.

Delete Organization Webhook Endpoint
DELETE/v1/organizations/webhooks/{webhook_endpoint_id}
Requires anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.

Delete an organization webhook endpoint.

Regenerate Organization Webhook Endpoint Signing Secret
POST/v1/organizations/webhooks/{webhook_endpoint_id}/regenerate_signing_secret
Requires anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.

Replace an organization webhook endpoint's signing secret. The old secret stops working immediately. The new secret is returned only in this response.

Models
BetaDeletedOrganizationWebhookEndpoint object{ type: "webhook_endpoint_deleted", id }

A deleted organization webhook endpoint.

type: "webhook_endpoint_deleted"

Always webhook_endpoint_deleted.

defaultwebhook_endpoint_deleted
id: string

ID of the deleted webhook endpoint.

BetaNewOrganizationWebhookEndpoint object{ id, created_at, description, 7 more }

A new organization webhook endpoint, with its signing secret.

BetaOrganizationWebhookEndpoint object{ id, created_at, description, 6 more }

A webhook endpoint that belongs to the organization rather than to one of its workspaces.

BetaOrganizationWebhookEndpointSigningSecret object{ signing_secret }

An organization webhook endpoint's new signing secret.

signing_secret: string

The new signing secret. Deliveries are signed with it from now on, and no other response returns it.

BetaOrganizationWebhookEndpointState = "disabled" or "enabled"

Whether deliveries are sent to an organization webhook endpoint.

One of the following:
"disabled"
"enabled"