Claude Platform Docs

Créer un point de terminaison de webhook d'organisation

$ ant beta:organization:webhooks create
POST/v1/organizations/webhooks

Créez un point de terminaison de webhook d'organisation.

Un point de terminaison de webhook d'organisation appartient à l'organisation plutôt qu'à l'un de ses espaces de travail. Une organisation peut avoir au maximum 32 points de terminaison de webhook d'organisation, activés ou désactivés.

La réponse inclut le secret de signature du point de terminaison. Aucune lecture ne le renvoie ; conservez-le donc dès que vous le recevez.

Chaque requête doit inclure l'en-tête bêta anthropic-beta: webhooks-2026-10-07. Une requête sans cet en-tête renvoie 404, exactement comme si cette API n'existait pas. Anthropic active les points de terminaison de webhook d'organisation pour chaque organisation ; tant que ce n'est pas le cas pour la vôtre, les requêtes renvoient également 404. Les points de terminaison de webhook d'organisation sont en bêta et ne sont pas disponibles pour les organisations dont la conformité HIPAA est activée.

Parameters
--enabled-event: 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.

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

--beta: optional array of AnthropicBeta⁠Header parameter

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

Returns
beta_new_organization_webhook_endpoint: object{ id, created_at, description, 7 more }

A new organization webhook endpoint, with its signing secret.

id: string

ID of the webhook endpoint.

created_at: string

When the endpoint was created, in RFC 3339 format.

formatdate-time
description: string

Notes about the endpoint. An empty string when none were given.

disabled_reason: string

Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.

enabled_events: array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"

The event types delivered to the endpoint.

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

A short label for the endpoint. An empty string when none was given.

signing_secret: string

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.

state: "disabled" or "enabled"

Whether deliveries are sent to the endpoint.

One of the following:
"disabled"
"enabled"
updated_at: string

When the endpoint was last changed, in RFC 3339 format.

formatdate-time
url: string

The HTTPS URL that deliveries are sent to.

Créer un point de terminaison de webhook d'organisation
ant beta:organization:webhooks create \
  --enabled-event 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"
}