API reference › Webhooks › Get endpoint

Get a webhook endpoint

GET/v1/webhooks/:id

One endpoint's configuration: its URL, which events it subscribes to, and whether it is currently disabled.

No CLI command yet — webhooks are managed over the API only.

curl -s https://api.propgate.dev/v1/webhooks/019fcf9a-3c4d-7e5f-a06b-7c8d9e0f1a2b \
  -H "authorization: Bearer pg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "data": {
    "createdAt": "2026-08-03T12:00:00.000Z",
    "disabled": false,
    "events": [
      "domain.failed",
      "domain.recovered"
    ],
    "id": "019fcf9a-3c4d-7e5f-a06b-7c8d9e0f1a2b",
    "object": "webhook",
    "url": "https://example.com/hooks/propgate"
  },
  "error": null,
  "meta": null
}

An id that does not exist, or belongs to a different account, is a 404 — the two are deliberately indistinguishable, so this endpoint cannot be used to discover whether an id exists on someone else's account:

{
  "data": null,
  "error": {
    "message": "no such webhook"
  },
  "meta": null
}