Claude Platform Docs

List Organization Webhook Endpoints

$client->beta->organization->webhooks->list(?string afterID, ?string beforeID, ?int limit, ?Order order, ?list<AnthropicBeta> betas): Page<OrganizationWebhookEndpoint>
GET/v1/organizations/webhooks
Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

List the organization's webhook endpoints.

An organization webhook endpoint belongs to the organization rather than to one of its workspaces. The list does not include webhook endpoints that belong to a workspace.

Every request must include the beta header anthropic-beta: webhooks-2026-10-07. A request without it returns 404, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return 404. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.

Parameters
afterID?: optional string⁠Query parameter

ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.

beforeID?: optional string⁠Query parameter

ID of a webhook endpoint to use as a cursor. Returns the first limit endpoints that come before it in list order, not the limit endpoints just before it.

limit?: optional int⁠Query parameter

Number of items to return per page, up to 100. The default, 0, means 20.

default0
order?: optional Order⁠Query parameter

Sort order by created_at. Defaults to desc, newest first.

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class OrganizationWebhookEndpoint { $id; $createdAt; $description; /* 6 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.

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.

List Organization Webhook Endpoints
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$page = $client->beta->organization->webhooks->list(
  afterID: 'after_id',
  beforeID: 'before_id',
  limit: 0,
  order: 'asc',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($page);
Returns Examples
Response 200
{
  "data": [
    {
      "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",
      "state": "disabled",
      "updated_at": "2019-12-27T18:11:19.117Z",
      "url": "url"
    }
  ],
  "has_more": true,
  "first_id": "first_id",
  "last_id": "last_id"
}