Claude Platform Docs

Создать конечную точку вебхука организации

POST/v1/organizations/webhooks

Создать конечную точку вебхука организации.

Конечная точка вебхука организации принадлежит организации, а не одному из её рабочих пространств. У организации может быть не более 32 конечных точек вебхуков организации, включённых или отключённых.

Ответ содержит секрет подписи конечной точки. Ни один запрос на чтение его не возвращает, поэтому сохраните его при получении.

Каждый запрос должен содержать бета-заголовок anthropic-beta: webhooks-2026-10-07. Запрос без него возвращает 404, точно так же, как если бы этого API не существовало. Anthropic включает конечные точки вебхуков организации для каждой организации отдельно; пока они не включены для вашей организации, запросы также возвращают 404. Конечные точки вебхуков организации находятся в бета-версии и недоступны организациям с включённой готовностью к HIPAA.

Headers
"anthropic-version": optional string

The version of the Claude API you want to use.

Read more about versioning and our version history here.

"anthropic-beta": optional array of AnthropicBeta

This endpoint is in beta: requests must send webhooks-2026-10-07 in this header.

One of the following:
string
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"ce-plugins-2026-09-01"
"spend-limit-reads-2026-09-26"
"telemetry-destinations-2026-08-11"
"webhooks-2026-10-07"
Body
enabled_events: array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"

The event types to deliver to the endpoint. Must list at least one.

One of the following:
"user_profile.enforcement_action_opened"
"user_profile.enforcement_action_resolved"
url: string

The HTTPS URL that deliveries are sent to.

minLength1
description: optional string

Notes about the endpoint.

name: optional string

A short label for the endpoint.

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

A new organization webhook endpoint, with its signing secret.

Создать конечную точку вебхука организации
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"
        }'
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"
}