Buat Endpoint Webhook Organisasi

$ ant beta:organization:webhooks create

POST/v1/organizations/webhooks

Buat endpoint webhook organisasi.

Endpoint webhook organisasi dimiliki oleh organisasi, bukan oleh salah satu workspace-nya. Sebuah organisasi dapat memiliki paling banyak 32 endpoint webhook organisasi, baik diaktifkan maupun dinonaktifkan.

Respons menyertakan signing secret endpoint. Tidak ada operasi baca yang mengembalikannya, jadi simpan secret tersebut saat Anda menerimanya.

Setiap permintaan harus menyertakan header beta anthropic-beta: webhooks-2026-10-07. Permintaan tanpa header tersebut mengembalikan 404, persis seolah-olah API ini tidak ada. Anthropic mengaktifkan endpoint webhook organisasi untuk setiap organisasi; sampai organisasi Anda diaktifkan, permintaan juga mengembalikan 404. Endpoint webhook organisasi masih dalam tahap beta dan tidak tersedia untuk organisasi yang mengaktifkan kesiapan HIPAA.

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

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.

Buat Endpoint Webhook Organisasi

ant beta:organization:webhooks create \
  --enabled-event user_profile.enforcement_action_opened \
  --url x

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