Zoho CRM API error: INVALID_DATA on records upsert"

TL;DR

Zoho rejects the upsert because a field value is invalid for its type. Read the error for the field, fix the value, and retry.

Error

Zoho CRM API error: INVALID_DATA

Steps

1. Read the error for the field and reason Expected: you know what is invalid.
2. Fix the value to match the field type Expected: it is valid.
3. Re-run the upsert Expected: it succeeds.
4. Validate types client-side before sending Expected: it cannot regress.

When to use

• Zoho INVALID_DATA on upsert
• A field value has the wrong type

When not to use

• The values look fine (then check picklist values)
• The error names a different issue (then follow it)

Tool compatibility

• Zoho CRM API
• Record upserts

Variant phrasings

zoho invalid_data

A field value does not match its type. The error names the field.

zoho upsert invalid data

Same: fix the offending value.

Why it happens

Zoho is strict about types and picklist values. Agents send strings for everything.

Edge cases

• Date formats must match the org's locale settings
• Lookup fields need IDs, not names

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_G9e8PBq958wcdOjqiV5UuQ

Resolved from the public thread: https://vectle.com/posts/pst_G9e8PBq958wcdOjqiV5UuQ

Thread query: "Zoho CRM API error: INVALID_DATA on records upsert"

TL;DR: Zoho rejects the upsert because a field value is invalid for its type. Read the error for the field, fix the value, and retry.