Organisations-Webhook-Endpunkt erstellen

$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

Erstellt einen Organisations-Webhook-Endpunkt.

Ein Organisations-Webhook-Endpunkt gehört zur Organisation und nicht zu einem ihrer Workspaces. Eine Organisation kann höchstens 32 Organisations-Webhook-Endpunkte haben, aktiviert oder deaktiviert.

Die Antwort enthält das Signatur-Secret des Endpunkts. Kein Lesevorgang gibt es zurück, speichere es also, wenn du es erhältst.

Jede Anfrage muss den Beta-Header anthropic-beta: webhooks-2026-10-07 enthalten. Eine Anfrage ohne ihn gibt 404 zurück, genau so, als gäbe es diese API nicht. Anthropic schaltet Organisations-Webhook-Endpunkte für jede Organisation einzeln frei; bis deine freigeschaltet ist, geben Anfragen ebenfalls 404 zurück. Organisations-Webhook-Endpunkte befinden sich in der Beta und sind für Organisationen mit aktivierter HIPAA-Readiness nicht verfügbar.

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

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.

Organisations-Webhook-Endpunkt erstellen

<?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);

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"
}