CUSTOMER_FIELD_INVALID_CHARACTERS

When it happens

A field of a row contains characters that are not allowed. The message names the field. It is reported in the row's errors.

How to fix it

Remove those characters from the value in that row.

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.

• POST /v1/companies/{company_id}/customers/bulk
• POST /v1/companies/{company_id}/customers/imports
• POST /v1/companies/{company_id}/customers/imports/preview

Example response

When this error occurs, the API returns a JSON response with the following shape:

{
  "type": "https://docs.beel.es/errors/CUSTOMER_FIELD_INVALID_CHARACTERS",
  "title": "CUSTOMER_FIELD_INVALID_CHARACTERS",
  "detail": "The field '‹value›' contains characters that are not allowed",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "CUSTOMER_FIELD_INVALID_CHARACTERS",
    "message": "The field '‹value›' contains characters that are not allowed",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

The type URI is stable and always resolves to this page.

Message

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Placeholders like ‹value› are filled in at runtime with the actual values of your request.

Other errors in this category

Keep exploring