MALFORMED_EVENT

Webhook body not JSON: what the MALFORMED_EVENT error means and how to fix it.

HTTP 400. Problem type: https://docs.ovok.com/errors/malformed-event.

What this means

The body of a webhook delivery is not valid JSON. The signature was already accepted, and Ovok stored nothing.

Troubleshooting

  1. Check that the sender posts JSON text, with the same bytes it signed. An empty, cut-off or differently encoded body, such as form fields, fails.
  2. For the FHIR store route, check that the Subscription's channel.payload is application/fhir+json, so each notification carries the Observation.
  3. For Signals, check that the delivery is the JSON event Signals sends. A hand-made test call needs a JSON body too.

Retry safely

Resend after you fix the sender. An unchanged delivery returns the same error. Nothing was stored, so a resend cannot duplicate anything.

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