Webhook Endpoints

Get webhook endpoint

GET /api/v1/webhook-endpoints/{id}

Returns a single webhook endpoint. Secret-carrying fields are never returned.

Response

{
  "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"
}

The endpoint object

url, auth_token, and signing_secret are write-only: they are accepted when creating or updating but never returned, because webhook URLs and tokens routinely carry credentials. url_host is the readable identifier for the destination.

FieldDescription
url_hostHost part of the configured URL (read-only)
auth_typenone, bearer, basic, or header
auth_header_nameHeader carrying the token when auth_type is header
severitiesSeverities this endpoint receives: critical, warning, info. Omitted on create means all three.
is_activeInactive endpoints are kept but receive nothing
last_delivered_atWhen an alert was last delivered here; null if never