heruAPI
Request errors

Validation errors

The request has a missing or invalid field.

link: https://developers.heru.app/errors/validation · status 422

The request reached heru but one or more fields are missing or have the wrong format. Nothing ran, so you can fix the request and send it again with the same Idempotency-Key.

422 Unprocessable Content
{
  "code": "VALIDATION_FAILED",
  "status": 422,
  "message": "Fix the fields listed in `fields` and retry.",
  "link": "https://developers.heru.app/errors/validation",
  "fields": [
    { "field": "curp", "reason": "must have 18 characters" }
  ],
  "request_id": "req_01m4ra8x59ehp870crwjcypejt"
}
CodeWhat happenedWhat to do
VALIDATION_FAILEDAt least one field failed. Each entry in fields names the field and the reason.Fix every field listed and send the request again.
WEBHOOK_URL_NOT_ALLOWEDheru will not deliver to the url of a webhook subscription: not https, credentials or a fragment in it, a port below 1024 other than 443, or a host that is private, local or resolves to a reserved address. fields[0].reason says which.Expose the endpoint on a public https host and send the URL again.
WEBHOOK_EVENT_TYPE_UNKNOWNAn entry of event_types is not a type heru publishes.Use the types of the events table, or * for every current and future type.
© 2026 Kuarto Inc. (heru)heru.appQuestions about your integration? Contact your heru account team.