Get a webhook endpoint

GET/v1/webhook_endpoints/{wh}

Read one endpoint. Never returns the secret.

Path ParametersExpand Collapse

wh: string

ReturnsExpand Collapse

WebhookEndpoint object { id, created_at, description, 3 more }

A URL your brand receives signed events on.

id: string

wh_….

created_at: string

formatdate-time

description: string

Your own label. Free text, ≤200 bytes, never interpreted.

enabled_events: array of string

The event types this endpoint receives. Exact names: no wildcards.

status: "enabled" or "disabled"

enabled while it receives deliveries, disabled once you turn it off. A disabled endpoint keeps its secret and its history and resumes on PATCH {"disabled": false}.

One of the following:

"enabled"

"disabled"

url: string

Absolute https URL every delivery for this endpoint is POSTed to.

Get a webhook endpoint

curl https://messages.api.linqapp.com/v1/webhook_endpoints/$WH \
    -H "Authorization: Bearer $LINQ_AMB_API_KEY"

{
  "id": "wh_7f3a1c9e",
  "url": "https://hooks.example.com/messages",
  "description": "production receiver",
  "enabled_events": [
    "message.received",
    "message.sent",
    "message.failed"
  ],
  "status": "enabled",
  "created_at": "2026-08-13T02:41:09Z"
}

Returns Examples

{
  "id": "wh_7f3a1c9e",
  "url": "https://hooks.example.com/messages",
  "description": "production receiver",
  "enabled_events": [
    "message.received",
    "message.sent",
    "message.failed"
  ],
  "status": "enabled",
  "created_at": "2026-08-13T02:41:09Z"
}