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.testevent 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.
idempotency_key_reused
This Idempotency-Key was already used with a different request. What causes the BioFlow API's idempotency_key_reused error (HTTP 422) and how to fix it.
endpoint_limit_reached
The workspace webhook endpoint limit was reached. What causes the BioFlow API's endpoint_limit_reached error (HTTP 422) and how to fix it.