POST
/webhooks Create Webhook
Creates a webhook subscription. The `eventTypes` array (e.g. `["LIGHT_SPEEDING","HARSH_BRAKING"]`) cannot be set through the explorer — send it directly via cURL or SDK. If `secretKey` is omitted the server auto-generates one; save it from the response body — it is masked on subsequent reads.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
name * | body | string | Human-readable webhook name.
e.g. Fleet Safety Alerts |
url * | body | string | HTTPS endpoint that will receive POST deliveries.
e.g. https://hooks.example.com/tracksafe/safety |
status | body | string | ACTIVE delivers events; DISABLED pauses all deliveries. ACTIVEDISABLED |
secretKey | body | string | HMAC-SHA256 signing secret. Auto-generated if omitted. Store it securely — treat as a password, never log.
e.g. whsec_my_signing_secret |
Response
Status: Stable. Try the request in the panel on the right to see a live response.