List Webhooks

Lists every webhook subscription on your account, newest first. Use it to audit what is subscribed before creating another (accounts cap at 10) and to spot subscriptions that have been auto-disabled.

Signing secrets are never included — they are shown only once, in the create response. A lost secret cannot be recovered: delete the subscription and create a new one.

Requirements: webhooks:manage scope + the public_api_webhooks feature.

Request

No parameters. The list is not paginated — an account holds at most 10 subscriptions.

Response

webhooksobject[]

webhook

idstring

Webhook subscription ID.

urlstring

The destination URL receiving deliveries.

eventTypesstring[]

Subscribed event types from the event catalog.

statusstring

ACTIVE or DISABLED. Disabled subscriptions receive no deliveries.

createdAtstring

ISO creation timestamp.

disabledAtstring | null

When the subscription was disabled; null while ACTIVE.

disabledReasonstring | null

Why it was disabled (e.g. repeated delivery failures). Recover by deleting and re-creating the subscription.

Errors

Status	code	Meaning
401	UNAUTHORIZED	Missing or invalid token
403	FORBIDDEN	Missing webhooks:manage scope, or public_api_webhooks disabled

Request examples

curlCLIMCP: opentrain_list_webhooks

curl

curl -sS https://app.opentrain.ai/api/public/v1/webhooks \
  -H "Authorization: Bearer $OT_API_TOKEN"

CLI

opentrain webhooks list --json

MCP: opentrain_list_webhooks

{}

Response examples

200

{
  "webhooks": [
    {
      "id": "<WEBHOOK_ID>",
      "url": "https://example.com/hooks/opentrain",
      "eventTypes": ["proposal.received", "message.received", "approval.confirmed"],
      "status": "ACTIVE",
      "createdAt": "2026-06-12T10:00:00.000Z",
      "disabledAt": null,
      "disabledReason": null
    },
    {
      "id": "<WEBHOOK_ID_2>",
      "url": "https://example.com/hooks/old-endpoint",
      "eventTypes": ["payment.pending"],
      "status": "DISABLED",
      "createdAt": "2026-05-30T08:00:00.000Z",
      "disabledAt": "2026-06-10T14:20:00.000Z",
      "disabledReason": "Disabled after repeated delivery failures"
    }
  ]
}