An ID validation error means your request referenced a record by its ID, but the ID was missing, the wrong type, out of range, or not in the expected format. The API rejects the request before doing any work, so nothing in your account is changed when you get this error. In most cases, the fix is to adjust the ID and re-send.
Every error in this family includes a stable code (for example VALD-1001). Find that code in the table at the bottom of this article to see exactly which rule was triggered.
Common causes
The ID field was left out, or sent as null or an empty string.
The ID was sent as the wrong type — for example, a string or a decimal where a whole integer is required.
The ID was zero or negative. iPaaS.com record IDs are always positive whole numbers.
A GUID or ObjectId value was malformed (wrong length or characters).
The wrong ID was supplied for the context — for example, a parent collection ID where the child record ID was expected.
How to fix it
Match the code in your response to the table below to see which rule failed.
Confirm the ID is present and not null or empty.
Check the type — numeric IDs must be whole integers greater than zero, with no quotes, decimals, or leading zeros.
Where a GUID or ObjectId is expected, confirm the value matches that format exactly.
Confirm you are sending the right ID for the right object (parent vs. child, internal vs. external).
Re-send the request. If it still fails with the same code, contact support with the code and your payload.
Codes in this family
Code | What it means |
| Id is null or empty in your request. |
| ID must be an integer. |
| Id must be larger than zero. |
| {object} is not a valid integer and/or must be greater than zero. |
| Provided Id is not in the proper format for this collection. |
| External Id is null or empty in your request. |
| {object} ID is null, empty or negative. |
| {object} ID is null or empty. |
| Id is null or empty. This should be the id of the parent collection |
| iPaaS.com ID provided is not valid. |
| Id must be larger than zero. |
| Id is null or empty. This should be the id of the a product or variant. |
| External Id is not valid on your request. |
| Id is null or empty. This should be the name of the related product type. |
| Company, First Name, or Last Name must not be null or empty |
| Table Id is not a valid integer or must be greater than 0. |
| Id must be an ObjectId format (24 char hexidecimal string (e.g. 507f1f77bcf86cd799439011)). |
| Required fields ({fieldNames]) is null or empty in your request. |
| Id provided ({id}) is not a valid Guid. |
| If you provide a parent in the child array it must match the parent ID. |
| Value ({value}) provided for {fieldName} is not valid. (see [CheckIdAsync](#id-validation-checkidasync)) |
| If Mapping Type is Lookup Translation, then a valid Lookup Translation Collection Id must be provided. |
| OpenAIFileStoreId is not configured. |