Create Organization Webhook Endpoint
POST/v1/organizations/webhooks
Create an organization webhook endpoint.
An organization webhook endpoint belongs to the organization rather than to one of its workspaces. An organization can have at most 32 organization webhook endpoints, enabled or disabled.
The response includes the endpoint's signing secret. No read returns it, so store it when you receive it.
Every request must include the beta header anthropic-beta: webhooks-2026-10-07. A request without it returns 404, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return 404. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.
Headers
Body
Returns
Create Organization Webhook Endpoint
curl https://api.anthropic.com/v1/organizations/webhooks \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: webhooks-2026-10-07' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-d '{
"enabled_events": [
"user_profile.enforcement_action_opened"
],
"url": "x"
}'Response 200
{
"id": "id",
"created_at": "2019-12-27T18:11:19.117Z",
"description": "description",
"disabled_reason": "disabled_reason",
"enabled_events": [
"user_profile.enforcement_action_opened"
],
"name": "name",
"signing_secret": "signing_secret",
"state": "disabled",
"updated_at": "2019-12-27T18:11:19.117Z",
"url": "url"
}Returns Examples
Response 200
{
"id": "id",
"created_at": "2019-12-27T18:11:19.117Z",
"description": "description",
"disabled_reason": "disabled_reason",
"enabled_events": [
"user_profile.enforcement_action_opened"
],
"name": "name",
"signing_secret": "signing_secret",
"state": "disabled",
"updated_at": "2019-12-27T18:11:19.117Z",
"url": "url"
}