List Webhooks - OpenTrain AI

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

webhooks

object[]

Show webhook

string

Webhook subscription ID.

url

string

The destination URL receiving deliveries.

eventTypes

string[]

Subscribed event types from the event catalog.

status

string

ACTIVE or DISABLED. Disabled subscriptions receive no deliveries.

createdAt

string

ISO creation timestamp.

disabledAt

string | null

When the subscription was disabled; null while ACTIVE.

disabledReason

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

​Request

​Response

​Errors

Request

Response

Errors