List Webhooks

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

opentrain webhooks list --json

{}

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

GET

api

public

webhooks

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

opentrain webhooks list --json

{}

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

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

object[]

Show webhook

string

Webhook subscription ID.

string

The destination URL receiving deliveries.

string[]

Subscribed event types from the event catalog.

string

ACTIVE or DISABLED. Disabled subscriptions receive no deliveries.

string

ISO creation timestamp.

string | null

When the subscription was disabled; null while ACTIVE.

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

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

opentrain webhooks list --json

{}

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

List Pending Payments

Create Webhook

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors