Register a disabled webhook endpoint

​

Creates a disabled, unverified HTTPS endpoint. A signing secret is returned only with this creation receipt; list reads never reveal it. Current application, organisation and Cell scope a 24-hour Idempotency-Key receipt; identical replay returns the same receipt, changed input conflicts, and expired commands cannot be reused. A later endpoint/key revision prevents creation replay from returning retired or replacement credentials. Registration does not enable notifications; endpoint-key verification and an admitted event producer remain required. All DNS addresses must be public at admission and each connection; credentials, fragments, redirects, private targets and non-443 ports are refused.

Headers

Body

required
application/json

Responses

  • application/json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
Request Example for post/v1/webhook-endpoints
curl https://api.dev.eno.health/v1/webhook-endpoints \
  --request POST \
  --header 'Idempotency-Key: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "url": "https://example.com",
  "eventTypes": [
    "document.processed"
  ]
}'
{
  "id": "string",
  "url": "https://example.com",
  "eventTypes": [
    "document.processed"
  ],
  "status": "disabled",
  "verificationStatus": "unverified",
  "revision": 1,
  "createdAt": "2026-11-16T18:04:16.439Z",
  "updatedAt": "2026-11-16T18:04:16.439Z",
  "signingSecret": "string"
}
Partner API reference · Check your integration’s enabled capabilities before making requests.