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エンドポイントは、組織内のいずれかのワークスペースではなく、組織自体に属します。1つの組織が持てる組織Webhookエンドポイントは、有効・無効を問わず最大32個です。

レスポンスにはエンドポイントの署名シークレットが含まれます。読み取り操作ではこれは返されないため、受け取った時点で保存してください。

すべてのリクエストにはベータヘッダー anthropic-beta: webhooks-2026-10-07 を含める必要があります。このヘッダーがないリクエストは、このAPIが存在しない場合とまったく同じように 404 を返します。Anthropicは組織ごとに組織Webhookエンドポイントを有効化します。お使いの組織で有効化されるまでは、リクエストは同様に 404 を返します。組織Webhookエンドポイントはベータ版であり、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"
}