Skip to main content

Required field errors

What the Required field error codes mean and how to resolve them.

A required field error means your request is missing a value that the endpoint requires. The API rejects the request before processing it.

Every error in this family includes a stable code (for example VALD-1002). Find that code in the table at the bottom of this article to see exactly which rule was triggered.

Common causes

  • A required field was omitted from the request.

  • A required field was sent as null or an empty string.

  • The field name was misspelled, so the value was not recognized.

  • The request body did not match the expected JSON structure.

How to fix it

  1. Match the code in your response to the table below to see which field is required.

  2. Add the missing field and give it a non-empty value.

  3. Check the field name spelling and casing against the API reference.

  4. Validate that your JSON structure matches the expected request shape.

  5. Re-send the request.

Codes in this family

Code

What it means

VALD-1002

Required field ({fieldName}) is null or empty in your request.

VALD-1003

Request is null or empty. This could be due to an invalid json structure.

VALD-1007

Table name ({TableName}) is null or empty in your request.

VALD-1014

Required field ({fieldName}) is null, empty or negative in your request.

VALD-1015

Custom Field Name is null or empty in your request.

VALD-1021

Email Address is null or empty.

VALD-1032

Request is null or empty.

VALD-1047

Email Address and/or password is null or empty.

VALD-1056

A Kit Component in the Variant Request is null or empty. This could be due to an invalid json structure.

VALD-1080

Refresh Token is null or empty in your request.

VALD-1093

PromoCode is null or empty.

VALD-1096

TrialExpirationDateTime is null or empty and is required when CompanyStatusId = TRIAL.

VALD-1112

The permission list in the request is null or empty.

Did this answer your question?