WEBHOOK_FIELDS_NOT_ALLOWED

Webhook fields on a non-subscriber: what the WEBHOOK_FIELDS_NOT_ALLOWED error means and how to fix it.

HTTP 422. Problem type: https://docs.ovok.com/errors/webhook-fields-not-allowed.

What this means

Webhook fields, which are webhookUrl, webhookSecret, events, custom, eventSchema and reach, belong to subscribers only, and the request set one on a client with another role. Signals saved nothing.

Troubleshooting

  1. Remove the webhook fields from a submitter or manager.
  2. Set role to SUBSCRIBER if the client should receive webhooks.

Retry safely

Fix the body 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