troubleshootingerrors

Error Reference

A reference guide for error codes and messages you may encounter.

Validation Errors

PropertyTypeDefaultDescription
REQUIRED_FIELDField levelA required field was submitted without a value.
MIN_LENGTHField levelText value is shorter than the configured minLength.
MAX_LENGTHField levelText value exceeds the configured maxLength.
PATTERN_MISMATCHField levelValue does not match the configured regex pattern.
MIN_VALUEField levelNumeric value is below the configured min.
MAX_VALUEField levelNumeric value exceeds the configured max.
INVALID_EMAILField levelEmail field value is not a valid email address.
INVALID_DATEField levelDate field value is outside the min/max date range.

API Errors

PropertyTypeDefaultDescription
401 UnauthorizedAPIInvalid or expired authentication token. Re-login.
403 ForbiddenAPIYou do not have permission to perform this action.
404 Not FoundAPIThe requested form, submission, or resource does not exist.
409 ConflictAPIA conflict occurred, often a duplicate field name or slug.
422 UnprocessableAPIThe request payload failed server-side validation.
429 Too Many RequestsAPIRate limit exceeded. Wait before retrying.
500 Server ErrorAPIInternal server error. Contact support if persistent.

Schema Errors

These errors appear in the Developer JSON editor when your form schema is invalid:

PropertyTypeDefaultDescription
DUPLICATE_NAMESchemaTwo or more fields share the same `name` value.
MISSING_TYPESchemaA field object is missing the required `type` property.
UNKNOWN_TYPESchemaThe `type` value is not a recognized field type.
MISSING_NAMESchemaA field is missing the required `name` property.
INVALID_FORMULASchemaA calculated field's formula expression has a syntax error.
CIRCULAR_DEPENDENCYSchemaA calculated field references itself or creates a circular chain.