View as markdown
Endpoints

Webhooks

A webhook is a trigger plus a delivery: a saved query or condition paired with where to send it.

MethodPathSummary
POSThttps://api.tickerbot.io/v2/webhooksCanonical create: a webhook is a trigger plus a delivery.
GEThttps://api.tickerbot.io/v2/webhooks/{id}Fetch one webhook subscription.
GEThttps://api.tickerbot.io/v2/webhooksList every webhook subscription on this account.
PATCHhttps://api.tickerbot.io/v2/webhooks/{id}Edit a webhook subscription in place.
DELETEhttps://api.tickerbot.io/v2/webhooks/{id}Delete a webhook subscription.
POSThttps://api.tickerbot.io/v2/webhooks/{id}/enableRe-enable a disabled webhook.
POSThttps://api.tickerbot.io/v2/webhooks/{id}/testSend a real-shape test POST to your endpoint, instantly.
GEThttps://api.tickerbot.io/v2/webhooks/{id}/deliveriesInspect recent deliveries for a webhook.

Four doors, one object

POST /v2/webhooks is canonical; four /subscribe shortcuts build the identical webhook.

POST /v2/webhooks is the canonical create — pass a discriminated trigger object (scan, ticker, signal, or event) plus your delivery fields. Four shortcut endpoints build the identical webhook if a simpler body reads better: POST /v2/scan/subscribe, /v2/tickers/{ticker}/subscribe, /v2/signals/{signal}/subscribe, and /v2/events/subscribe. Whichever door you use, the webhook is listed and managed through the registry above — fetch and list, update the trigger or target, audit deliveries, re-enable after auto-suspension, and delete.