Create a Sales Order Record via the API using a Contact external ID

I am trying to create or upsert a Sales Order via the API using an external ID for a lookup. https://www.zoho.com/crm/developer/docs/api/v6/records-api-ext-id-overview.html

I use an external ID for the Contact Lookup:
"Contact_Name":{"FastSpring_Account_ID":"l6NPd8ygTm-qR5Vrfgru8rg"}, but the API returns an error required field (id) not found,

{
  "response": {
    "status": 400,
    "body": {
      "data": [
        {
          "code": "MANDATORY_NOT_FOUND",
          "details": {
            "api_name": "id",
            "json_path": "$.data[0].Contact_Name.id"
          },
          "message": "required field not found",
          "status": "error"
        }
      ]
    }
  },
  "request": {}
}

Why? The FastSpring_Account_ID is properly set as an external ID at contact level.

I've tried to Pass the following headers, but with no success so far:

X-EXTERNAL: Sales_Orders.Contact_Name.Contact.FastSpring_Account_ID
X-EXTERNAL: Sales_Orders.Contact_Name.FastSpring_Account_ID
X-EXTERNAL: Contact.Contact_Name.FastSpring_Account_ID
X-EXTERNAL: Contact.FastSpring_Account_ID

I want to use the external ID to avoid an extra API call returning the actual ID of the contact.

Zoho Developer Community

New to Zoho LandingPage?

Access Zoho LandingPage

Zoho LandingPage Resources

New to Zoho Survey?

Access Zoho Survey

Latest Feature Updates

Explore our Pricing & Plans

Zoho Survey Resources

Android Mobile Surveys

Insurvey Blogs

Insight Blogs

Tips & Tricks

New to Zoho CRM Plus?

Deliver unforgettable customer experiences

ACCESS ZOHO CRM PLUS

New to Zoho CRM Plus?

Deliver unforgettable customer experiences

ACCESS ZOHO CRM PLUS

New to Zoho Marketing Plus?

Everything you need to run your marketing

ACCESS ZOHO MARKETING PLUS

New to Zoho Marketing Plus?

Everything you need to run your marketing

ACCESS ZOHO MARKETING PLUS

New to Bigin?

Signup Now

Access Bigin

Latest Feature Updates

Zoho Desk Resources

Desk Community Learning Series
Digest
Functions
Meetups
Kbase
Resources
Glossary
Desk Marketplace
MVP Corner
Word of the Day

Tout forum

France ZUGs

Zoho SalesIQ Resources

Topic Participants
Joseph Leveque
Ishwarya SG

Sticky Posts
Kaizen #152 - Client Script Support for the new Canvas Record Forms
Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achieved
Extension pointers for integrating Zoho CRM with Zoho products #8: Upload and manage Zoho Workdrive folders and files from within Zoho CRM
Keeping records on your customers and business prospects is essential for tracking data, conducting follow-ups, and running a business smoothly. When you use two separate applications, and store relevant data in each, checking and tracking data becomes
Kaizen #142: How to Navigate to Another Page in Zoho CRM using Client Script
Hello everyone! Welcome back to another exciting Kaizen post. In this post, let us see how you can you navigate to different Pages using Client Script. In this Kaizen post, Need to Navigate to different Pages Client Script ZDKs related to navigation A.
Extension pointers #13: Handle cases with personalized solutions using custom actions
In our last post, we detailed the steps involved in creating a custom action and the workflow from the developer and end user's side. Now let's look at a working example of how we can create a custom action and implement it in a Zoho CRM account to make
Extension pointers - Simple yet significant pointers #13: On change of field value for CRM variables
CRM variables provide global access to a variable across an entire extension. They also help in the storage of user-specific data provided by the user at the time of installation, which can later be fetched to perform data functionalities. Additionally,