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
- Type: stringIdempotency
- Key min length:1max length:255required
Body
required
application/json
- Type: array of "document.processed" or "document.failed" or "document.downloaded" 1…3 unique!enumevent
Types required - Type: stringurlmax length:2048Format: urirequired
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"
}