Claude Platform Docs

Crea endpoint webhook dell'organizzazione

$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

Crea un endpoint webhook dell'organizzazione.

Un endpoint webhook dell'organizzazione appartiene all'organizzazione anziché a uno dei suoi workspace. Un'organizzazione può avere al massimo 32 endpoint webhook dell'organizzazione, abilitati o disabilitati.

La risposta include il segreto di firma dell'endpoint. Nessuna lettura lo restituisce, quindi conservalo quando lo ricevi.

Ogni richiesta deve includere l'header beta anthropic-beta: webhooks-2026-10-07. Una richiesta senza di esso restituisce 404, esattamente come se questa API non esistesse. Anthropic attiva gli endpoint webhook dell'organizzazione per ciascuna organizzazione; finché non sono attivi per la tua, le richieste restituiscono ugualmente 404. Gli endpoint webhook dell'organizzazione sono in beta e non sono disponibili per le organizzazioni con la predisposizione HIPAA abilitata.

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.

Crea endpoint webhook dell'organizzazione
<?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"
}