Claude Platform Docs

建立組織 Webhook 端點

$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

建立組織 webhook 端點。

組織 webhook 端點屬於組織，而非其中某個工作區。一個組織最多可擁有 32 個組織 webhook 端點（無論已啟用或已停用）。

回應中包含端點的簽署密鑰。任何讀取操作都不會傳回此密鑰，因此請在收到時妥善儲存。

每個請求都必須包含 beta 標頭 anthropic-beta: webhooks-2026-10-07。未包含此標頭的請求會傳回 404，就如同此 API 不存在一樣。Anthropic 會為每個組織個別開啟組織 webhook 端點功能；在您的組織開啟之前，請求也會傳回 404。組織 webhook 端點目前為 beta 版，且不適用於已啟用 HIPAA 就緒的組織。

Parameters
enabledEvents: list<EnabledEvent>

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

url: string

The HTTPS URL that deliveries are sent to.

description?: optional string

Notes about the endpoint.

name?: optional string

A short label for the endpoint.

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
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.

建立組織 Webhook 端點
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaNewOrganizationWebhookEndpoint = $client
  ->beta
  ->organization
  ->webhooks
  ->create(
  enabledEvents: ['user_profile.enforcement_action_opened'],
  url: 'x',
  description: 'description',
  name: 'name',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaNewOrganizationWebhookEndpoint);
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"
}