Link alert to webhook (V2)
Webhooks
Link alert
Links an alert configuration to an existing webhook.
POST
Link alert to webhook (V2)
Overview
Adds an alert configuration to an existing webhook’s subscription list. Idempotent — if the alert is already linked, the response is200 with no change.
Use this when you want to add alerts one at a time after creation, rather than updating the full alertIds list via PUT /v2/api/webhooks/{id}.
Rate limit: 4 req/s · 20/min · 600/hr · 14,400/day
Endpoint
POST /v2/api/webhooks/{id}/link-alert
Path parameters
integer
required
Webhook ID.
Request body
Response
200 OK — empty body on success.Error responses
Authorizations
JWT Bearer token obtained from POST /v2/api/authentication/token/api-key.
Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.
Scoping: API key tokens are scoped to the company the key belongs to and may restrict access to a vehicle allowlist and/or action set (see token claims).
No refresh endpoint — re-authenticate with your API key when the token expires.
Path Parameters
Body
application/json
Example:
103
Response
200 OK — Empty body. Alert linked successfully.