Claude Platform Docs

Webhooks

Create Organization Webhook Endpoint
POST/v1/organizations/webhooks

Create an organization webhook endpoint.

List Organization Webhook Endpoints
GET/v1/organizations/webhooks

List the organization's webhook endpoints.

Get Organization Webhook Endpoint
GET/v1/organizations/webhooks/{webhook_endpoint_id}

Retrieve an organization webhook endpoint by ID.

Update Organization Webhook Endpoint
POST/v1/organizations/webhooks/{webhook_endpoint_id}

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

Delete Organization Webhook Endpoint
DELETE/v1/organizations/webhooks/{webhook_endpoint_id}

Delete an organization webhook endpoint.

Regenerate Organization Webhook Endpoint Signing Secret
POST/v1/organizations/webhooks/{webhook_endpoint_id}/regenerate_signing_secret

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"