Skip to main content
Maestra validates every field when data enters the system — from imports, integrations, forms, and API calls. Validation keeps your customer database clean by checking that each value contains only permitted characters and fits within length limits. This page covers the rules for each field type so you know what Maestra will accept and what it will reject.

​
How validation works

When Maestra receives data for a customer profile, it checks each field against its validation rules. Invalid values aren’t saved. In most cases the operation still completes with a warning, and all valid fields on the same record are preserved — only the bad field is dropped. There are a few exceptions where the whole operation fails:
  • A full name exceeds the character limit.
  • An enumeration field exceeds its character limit or contains the | character.
  • The only identifier supplied for a customer is invalid (Maestra can’t match or create a customer without at least one valid identifier).
Validation rules apply to all entry points — imports, API, integrations, pop-ups, in-app forms, and any other source that writes to a customer profile.

​
Full name

​
Default: Latin alphabet

By default, full name fields accept Latin letters with a small set of allowed punctuation. Regex pattern: ^[A-Za-z][A-Za-z'\- ]*$ Rules:
  • The first character must be a letter.
  • Subsequent characters can be letters, apostrophes, hyphens, or spaces.
  • Each field (first name, last name, middle name) is limited to 100 characters.
If a name exceeds 100 characters, the entire operation fails — Maestra does not truncate the value or save the rest of the record.

​
Alternative alphabets

You can switch the full name validation to one of several alphabets: English, Belarusian, Kazakh, Kyrgyz, Polish, Ukrainian, or an “any characters” option that supports a broad set of Unicode scripts. The “any characters” option accepts characters from these Unicode blocks:
  • Arabic
  • Armenian
  • Bengali
  • Cherokee
  • Cyrillic
  • Devanagari
  • Ethiopian
  • Georgian
  • Greek
  • Hebrew
  • Hiragana
  • Kannada
  • Khmer
  • Malayalam
  • Mongolian
  • Myanmar
  • Tamil
  • Telugu
  • Thai
  • Tibetan
  • CJK (Chinese, Japanese, Korean)
It also allows digits and the following symbols: 
` ' ' ' - . ( ) + = ? * / " ! , _ @ № : ·
Even with the “any characters” option, a single field cannot mix symbols from different languages. For example, a first name can’t contain both Cyrillic and Greek letters.

​
Mobile number

​
Allowed characters

Only digits are stored. Maestra strips parentheses, hyphens, plus signs, and spaces during processing, so customers can enter numbers in any common format and the value will normalize correctly.

​
Country codes

Mobile numbers must begin with a country code. Both international and domestic prefixes are accepted on input, but the number is always saved in international format.

​
Length

  • US numbers: country code (1) plus 10 digits.
  • Other countries: at least one digit after the country code, with a total length of up to 19 digits.
If your number isn’t being accepted, check that it includes a valid country code and that the total length (digits only) is between the country code’s minimum and 19.

​
Email

Maestra validates email addresses against a regex that enforces the structure below:
  • Before the @: at least one character. Allowed characters are letters, digits, and _ - ! # $ % & ' * + / = ? ^ ` { } | ~.
  • After the @: one or more domain groups separated by periods. Each group is 1–63 characters long, and the first and last characters must be a letter or digit.
  • Total length: up to 254 characters.
Addresses that don’t match this pattern are rejected.

​
Gender

Gender accepts the following values (case-insensitive):
MaleFemale
malefemale
mf
mw

​
Custom fields

You can add custom fields to a customer profile. Each custom field has a type, and the type determines its validation rules.

​
String / Identifier

  • Any characters.
  • Up to 1,000 characters.

​
Enumeration

  • Any characters except | (the pipe character is reserved as a value separator).
  • Up to 250 characters per value.
If an enumeration value exceeds 250 characters or contains a |, the entire operation fails.

​
Integer

  • Digits only.
  • Range: −2,147,483,648 to 2,147,483,647.

​
Decimal

  • Digits with either a period or a comma as the decimal separator.
  • Up to 16 digits before the separator and 2 digits after.
  • Range: −9,999,999,999,999,999.99 to 9,999,999,999,999,999.99.

​
Boolean

Boolean fields accept any of the following (case-insensitive):
TrueFalse
truefalse
yesno
10

​
Date and date-time

Maestra accepts 29 distinct date and date-time formats, including common variants such as:
  • dd.MM.yyyy
  • yyyy-MM-dd
  • MM/dd/yyyy
These formats are available with and without optional time components.
If you submit a date-time value to a date-only field, Maestra discards the time portion and stores just the date.

​
Validation failures at a glance

1

Invalid value, operation continues

Most invalid values are dropped with a warning. Other valid fields on the same record are saved.
2

Invalid value, operation fails

The operation is rejected outright if a full name exceeds its character limit, an enumeration value exceeds its limit or contains |, or the only customer identifier provided is invalid.