WEBHOOK_REQUIRED

Subscriber webhook required: what the WEBHOOK_REQUIRED error means and how to fix it.

HTTP 422. Problem type: https://docs.ovok.com/errors/webhook-required.

What this means

A subscriber needs somewhere to send events, and the request did not give it. Every subscriber needs webhookUrl, and a subscriber on event schema 1 also needs webhookSecret. Signals saved nothing.

Troubleshooting

  1. Read detail. It names the missing field.
  2. Send webhookUrl with the receiver's URL.
  3. On event schema 1, send webhookSecret too, or move the subscriber to a later event schema, which signs deliveries with a secret Signals generates.

Retry safely

Add the fields and send the request once. Unchanged, it fails again. Nothing was saved.

If the problem persists

Share the HTTP status, problem type, request path, response timestamp and traceId with your administrator or support contact. Remove access tokens, provider secrets and patient data first. The Error responses guide explains the response fields, and the machine-code registry lists every endpoint-specific type.

Last updated on

On this page