A format or range validation error means a value is in the wrong format, outside the allowed range, or not one of the accepted values.
Every error in this family includes a stable code (for example VALD-1010). Find that code in the table at the bottom of this article to see exactly which rule was triggered.
Common causes
A date, number, or enum value is in the wrong format.
A value is below the minimum or above the maximum allowed.
A value is not in the set of allowed options.
How to fix it
Match the code in your response to the table below.
Reformat the value to match what the field expects.
Keep numeric values within the allowed range.
Use one of the accepted values listed in the message or the API reference.
Re-send the request.
Codes in this family
Code | What it means |
| The value you are trying to set for {field} has a defined set of allowed values. The value you provided ({value}) does not exist or can not be found. |
| Email ({emailTemplateId}) not found, is null or not in a valid format. |
| {field} has an invalid value. This must be between {min} and {max}. |
| Invalid value for {field}. This field must be one of the allowed values: {allowedValuesCommaSeperated}. |
| Invalid severity id: {type}. Valid values are: Verbose, Info, Warning, Error, None, Critical |
| Value ({value}) provided for {fieldName} is not valid. |
| You tried to add a new {versionType} version that is smaller than the existing one. Please make sure it's larger than the previous ones. |
| Invalid Type: {tableName}. Please specify a correct type: Product or Variant |
| PromoApplicationTypeId is invalid. The value must be between {min} and {max}. |
| {field} provided in filter ({value}) must be a Guid. |
| Invalid value specified for AggregationTime. It must be an integer with the value 0 (Hour) or 1 (Day). |
| Your password reset token has expired. Please try again. |
| AggregationValue must be in the format YYYY if AggregationTime is 4. |
| AggregationValue must be in the format YYYY-MM if AggregationTime is 3. |
| AggregationValue must be in the format YYYY-MM-dd if AggregationTime is 1. |
| BillDay is invalid. The value must be between 1 and 28. |
| Refresh Token is expired or invalid. Please log in again |
| AggregationDate is not a supported date/time format. |
| AggregationType must be one of: (0=All, 1=by MappingCollectionTypeId, 2=by StatusId). |
| AggregationValue must be in the format YYYY-ww if AggregationTime is 2. |
| DesignationTypeId provided in filter must be an integer and {value} is not. |
| You are unable to set a company as an MiSP at creation. |
| Missing or invalid Authorization header. |
| Invalid {sourceOrDestination} field id: {fieldId}. |
| A category can not be a parent of itself. You provided {id} for both the ID of the parent and child. |
| Invalid request. A query string is required to process OAuth. |
| Invalid company specified. You must leave company unspecified or specify the correct company id. |