Claude Platform Docs

Webhooks

Create Organization Webhook Endpoint
$client->beta->organization->webhooks->create(list<EnabledEvent> enabledEvents, string url, ?string description, ?string name, ?list<AnthropicBeta> betas): NewOrganizationWebhookEndpoint
POST/v1/organizations/webhooks
Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

Create an organization webhook endpoint.

List Organization Webhook Endpoints
$client->beta->organization->webhooks->list(?string afterID, ?string beforeID, ?int limit, ?Order order, ?list<AnthropicBeta> betas): Page<OrganizationWebhookEndpoint>
GET/v1/organizations/webhooks
Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

List the organization's webhook endpoints.

Get Organization Webhook Endpoint
$client->beta->organization->webhooks->retrieve(string webhookEndpointID, ?list<AnthropicBeta> betas): OrganizationWebhookEndpoint
GET/v1/organizations/webhooks/{webhook_endpoint_id}
Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

Retrieve an organization webhook endpoint by ID.

Update Organization Webhook Endpoint
$client->beta->organization->webhooks->update(string webhookEndpointID, ?string description, ?list<EnabledEvent> enabledEvents, ?string name, ?State state, ?string url, ?list<AnthropicBeta> betas): OrganizationWebhookEndpoint
POST/v1/organizations/webhooks/{webhook_endpoint_id}
Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

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

Delete Organization Webhook Endpoint
$client->beta->organization->webhooks->delete(string webhookEndpointID, ?list<AnthropicBeta> betas): DeletedOrganizationWebhookEndpoint
DELETE/v1/organizations/webhooks/{webhook_endpoint_id}
Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

Delete an organization webhook endpoint.

Regenerate Organization Webhook Endpoint Signing Secret
$client->beta->organization->webhooks->regenerateSigningSecret(string webhookEndpointID, ?list<AnthropicBeta> betas): OrganizationWebhookEndpointSigningSecret
POST/v1/organizations/webhooks/{webhook_endpoint_id}/regenerate_signing_secret
Requires anthropic-beta: webhooks-2026-10-07. 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
class DeletedOrganizationWebhookEndpoint { $type = 'webhook_endpoint_deleted'; $id; }
"webhook_endpoint_deleted" type

Always webhook_endpoint_deleted.

string id

ID of the deleted webhook endpoint.

class NewOrganizationWebhookEndpoint { $id; $createdAt; $description; /* 7 more */ }
string id

ID of the webhook endpoint.

\Datetime createdAt

When the endpoint was created, in RFC 3339 format.

string description

Notes about the endpoint. An empty string when none were given.

string disabledReason

Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.

list<EnabledEvent> enabledEvents

The event types delivered to the endpoint.

string name

A short label for the endpoint. An empty string when none was given.

string signingSecret

The secret Anthropic signs deliveries to the endpoint with (prefix whsec_). No other response returns it, so store it now. To replace it, regenerate the signing secret.

OrganizationWebhookEndpointState state

Whether deliveries are sent to the endpoint.

\Datetime updatedAt

When the endpoint was last changed, in RFC 3339 format.

string url

The HTTPS URL that deliveries are sent to.

class OrganizationWebhookEndpoint { $id; $createdAt; $description; /* 6 more */ }
string id

ID of the webhook endpoint.

\Datetime createdAt

When the endpoint was created, in RFC 3339 format.

string description

Notes about the endpoint. An empty string when none were given.

string disabledReason

Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.

list<EnabledEvent> enabledEvents

The event types delivered to the endpoint.

string name

A short label for the endpoint. An empty string when none was given.

OrganizationWebhookEndpointState state

Whether deliveries are sent to the endpoint.

\Datetime updatedAt

When the endpoint was last changed, in RFC 3339 format.

string url

The HTTPS URL that deliveries are sent to.

class OrganizationWebhookEndpointSigningSecret { $signingSecret; }
string signingSecret

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

enum OrganizationWebhookEndpointState
One of the following:
"disabled"
"enabled"