BioFlow / API docs / Errors / endpoint_verification_failed

`endpoint_verification_failed`

HTTP 422application/problem+json

The webhook endpoint did not accept the signed test event.

Open in Claude ↗Open in ChatGPT ↗

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.

Wire format

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 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.