POST
/api/v1/webhook-endpoints
Creates an outbound webhook endpoint for the team. Alerts matching the endpoint's severities are delivered to its URL with the configured authentication.
Request Body
| Parameter | Type | Description |
|---|---|---|
name | string | Required. Display name, max 100 characters |
url | string | Required. HTTPS destination URL (write-only; may carry query-string secrets) |
auth_type | string | Required. none, bearer, basic, or header |
auth_token | string | Required for bearer, basic, and header auth (write-only) |
auth_header_name | string | Required for header auth; letters, digits, and hyphens |
signing_secret | string | Optional HMAC signing secret, 16 to 255 characters (write-only) |
severities | array | Which severities to deliver: critical, warning, info. Omit for all. |
is_active | boolean | Defaults to true |
Response
Returns the created endpoint object with status 201.
{
"id": 4,
"name": "Rootly",
"url_host": "webhooks.rootly.com",
"auth_type": "bearer",
"auth_header_name": null,
"severities": ["critical", "warning"],
"is_active": true,
"last_delivered_at": "2026-08-14T17:46:02Z",
"created_at": "2026-08-13T15:31:44Z"
}