Update a webhook endpoint

PATCH/v1/webhook_endpoints/{wh}

Change the URL, the subscribed events, the label, or whether it is delivering. Omitted fields are left alone.

Path ParametersExpand Collapse

wh: string

Body ParametersJSONExpand Collapse

description: optional string

disabled: optional boolean

true stops deliveries without deleting the endpoint; false resumes them.

enabled_events: optional array of string

url: optional 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.

Update a webhook endpoint

curl https://messages.api.linqapp.com/v1/webhook_endpoints/$WH \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LINQ_AMB_API_KEY" \
    -d '{}'

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