BioFlow
APIError codes

endpoint_verification_failed

The webhook endpoint did not accept the signed test event. What causes the BioFlow API's endpoint_verification_failed error (HTTP 422) and how to fix it.

HTTP 422 · application/problem+json · The webhook endpoint did not accept the signed test event.

What causes it

  • When creating a webhook endpoint (or changing its URL), BioFlow sends a signed endpoint.test event synchronously — your endpoint did not respond 2xx.

How to fix it

  • Make the endpoint reachable over HTTPS and respond 2xx to the verification POST, then retry.
  • Verify signatures over the RAW request bytes — parsing and re-serializing the body before verifying breaks the signature.

Example response body

{
  "type": "https://getbioflow.com/docs/api/errors/endpoint-verification-failed",
  "title": "The webhook endpoint did not accept the signed test event",
  "status": 422,
  "instance": "urn:request:req_01abc",
  "code": "endpoint_verification_failed",
  "request_id": "req_01abc"
}

Branch on the stable code field — title and detail are for humans and may change. type (https://getbioflow.com/docs/api/errors/endpoint-verification-failed) always resolves to this page. Quote request_id when contacting support. Full code registry on the API docs hub; the complete surface is in the interactive reference.

On this page