INVOICE_EMAIL_NO_RECIPIENTS

There are no recipients: send them in the request.

Category: Invoices


HTTP status	`422` Unprocessable Content
Retry	After fixing the cause

When it happens

There is nobody to send the email to. On a single invoice: the request carries no recipients, the invoice has none in its email_config, and its recipient has no email address. On a batch, recipients is required: it is not completed from any profile or customer.

How to fix it

Send recipients in the request. For a single invoice you can instead give the customer a billing_emails or email address and send again.

Retry

Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.

Returned by

The operations where this code is most likely. The list is not exhaustive.

Example response

When this error occurs, the API answers 422 Unprocessable Content with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/INVOICE_EMAIL_NO_RECIPIENTS",
  "title": "INVOICE_EMAIL_NO_RECIPIENTS",
  "detail": "There are no recipients: send them in the request.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "INVOICE_EMAIL_NO_RECIPIENTS",
    "message": "There are no recipients: send them in the request.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}