← tickerbot.io
View as markdown
Endpoints › Webhooks

Re-enable a webhook

POSThttps://api.tickerbot.io/v2/webhooks/{id}/enable

Re-enable a disabled webhook and start it clean.

Body parameters

stringrequired

Webhook id.

Returns

as_ofstring

Server time this response was assembled (ISO 8601).

idstring

The webhook id — `wh_…`, the handle for every other call on this record.

namestring

Your label for the subscription.

qstring

The stored predicate. Custom signals appear expanded: the SQL is frozen at creation.

rule_idstring

Legacy link to a v1 alert rule; `null` on everything created through v2.

fieldsstring

Extra signals carried on each fired match row; `null` means the standard set.

orderstring

Sort signal for the payload row list; `null` means the evaluator default (`market_cap`).

dirstring

Sort direction for that list; `null` means the default (`desc`).

universe_idstring

Universe the trigger is scoped to, or `null` for the whole market.

cadencestring

How often the trigger is evaluated — `realtime`, `hourly`, or `nyse_open`.

channelstring

Where deliveries go: `webhook`, `discord`, `in_app`, or `mobile_push`.

target_urlstring

Your HTTPS endpoint; `null` on every channel except `webhook`.

deliverystring

Legacy alias of `channel`, kept aligned for older readers.

statusstring

`active` or `disabled`. Auto-disable follows repeated delivery failure.

sourcestring

Which API version created the record; `v2` for anything you create today.

subscription_originobject

Which door created it — `type` (`ticker`/`signal`/`scan`/`event`), its `ref`, and the `condition` in display form.

last_predicate_valuestring

The trigger's value at the last evaluation; `null` until it has run.

created_atnumber

Creation timestamp.

updated_atnumber

Last modification timestamp.

last_firednumber

When a delivery last went out; `null` if it never has.

last_match_setarray

Tickers matching at the last evaluation — the set the next run is diffed against, which is what makes firing edge-triggered.

last_eval_error_atnumber

When the last evaluation error happened; `null` on a healthy hook.

last_errorstring

The last evaluation error; `null` on a healthy hook. The answer to "why is my webhook not firing?".

next_eval_atnumber

When the evaluator will next consider this subscription.

last_evaluated_atnumber

When it was last evaluated; `null` until the first run.

event_kindsarray

Event-trigger webhooks only: the kinds subscribed (`split`, `dividend`, `insider`, `analyst`, `earnings`).

event_qstring

Event-trigger webhooks only: the payload filter, or `null`.

event_tickersarray

Event-trigger webhooks only: the symbols the trigger is scoped to, or `null` for the universe / whole market.

trigger_kindstring

Event-trigger webhooks only: `event`.

Status codes

200
The updated webhook (now active).
400
Malformed webhook id.
403
webhook_over_limit — the account holds more webhooks than the plan allows (typically after a downgrade; on Free, any webhook is over the cap). Delete webhooks until you're within the limit, or upgrade.
404
Webhook not found.

Notes

  • Flips the webhook back to active and clears its match-state cache, so the next eval treats every currently-matching ticker as new and fires a single webhook.fired. Use it after fixing whatever caused the auto-disable.
  • To validate your receiver before real fires reach it, call POST /v2/webhooks/{id}/test first.
  • Calling enable on an already-active webhook is a no-op — returns the current record unchanged.
  • Re-enable clears last_match_set and last_evaluated_at so the next eval treats every currently-matching ticker as new and fires a single webhook.fired. To validate the receiver before resuming real fires, call POST /v2/webhooks/{id}/test.