Webhooks

Get a webhook

One webhook, including its pause state and delivery timestamps. Never includes the secret.

get/webhooks/{id}

Request

Base URL: https://optionsbell.com/api/v1
URL: https://optionsbell.com/api/v1/webhooks/{id}
Auth: API key in header X-API-Key

Response

The webhook

idstring required

namestring required

urlstring uri required

tickersstring[] required

Upper-cased, de-duplicated. Max 150.

notify_interval_min10 | 30 | 60 | 240 | 480 | 1440 required

Minimum minutes between two deliveries.

is_activeboolean required

false: not evaluated at all (set via PATCH).

paused_atstring date-time nullable required

Set when the webhook was paused after 20 consecutive failed deliveries; null otherwise. Paused webhooks are still evaluated but not delivered to.

consecutive_failuresinteger required

Failed unusual_activity deliveries in a row; reset to 0 by any successful delivery, a successful test, or a PATCH with url / is_active: true.

last_run_atstring date-time nullable required

Last evaluation (UTC), whether or not anything was delivered.

last_delivered_atstring date-time nullable required

Last successful unusual_activity delivery (UTC). The cooldown (notify_interval_min) counts from here.

created_atstring date-time required

updated_atstring date-time required

Example response

{
  "id": "cmg1x2y3z0000abcd12345678",
  "name": "NVDA/TSLA calls",
  "url": "https://example.com/hooks/optionsbell",
  "tickers": [
    "NVDA",
    "TSLA"
  ],
  "active_hours": {
    "start": "09:00",
    "end": "16:00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.