Claude Platform Docs

Webhooks

Create Organization Webhook Endpoint
$ ant beta:organization:webhooks create
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
$ ant beta:organization:webhooks list
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
$ ant beta:organization:webhooks retrieve
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
$ ant beta:organization:webhooks update
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
$ ant beta:organization:webhooks delete
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
$ ant beta:organization:webhooks regenerate-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
beta_deleted_organization_webhook_endpoint: object{ type: "webhook_endpoint_deleted", id }

A deleted organization webhook endpoint.

type: "webhook_endpoint_deleted"

Always webhook_endpoint_deleted.

id: string

ID of the deleted webhook endpoint.

beta_new_organization_webhook_endpoint: object{ id, created_at, description, 7 more }

A new organization webhook endpoint, with its signing secret.

beta_organization_webhook_endpoint: object{ id, created_at, description, 6 more }

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

beta_organization_webhook_endpoint_signing_secret: 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.

beta_organization_webhook_endpoint_state: "disabled" or "enabled"

Whether deliveries are sent to an organization webhook endpoint.

"disabled"
"enabled"