Common COQL Errors
COQL "Minimum Successful Response" script for testing/setup:
queryMap = Map();
query = "select Last_Name from Contacts where Last_Name is not null" queryMap.put("select_query", query);
response = invokeUrl [
url: coqlurl
type: POST
parameters: queryMap.toString()
connection: "zcrm" ];
info response;
Generic Error Message (may be sent for a number of issues): {"code":"INVALID_REQUEST","details":{},"message":"unable to process your request. please verify whether you have entered proper method name, parameter and parameter values.","status":"error"}
Things to check:
1. API version, try both v2 and v3
2. If using a Zoho "Connection" feature, make sure COQL is explicitly enabled in the scope using a Zoho OAuth connection.
3. COQL requires mandatory WHERE clauses on all requests! This can be something trivial like "where Last_Name is not null"
4. COQL does not support all modules the way the api does. At present (July 2022) COQL can query the following modules:
leads, accounts, contacts, deals, campaigns, tasks, cases, events, calls, solutions, products, vendors, pricebooks, quotes, salesorders, purchaseorders, invoices, and custom modules
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Using Gmail API
Zoho CRM provides a variety of emailing options that users can choose based on their requirements. One such option is the Zoho Mail Add-on. With Zoho Mail Add-on, you can configure your email client within Zoho CRM using either one of the two ...Common Operations with records
Record Navigation Navigation primarily means the process of moving back and forth within the records. In Zoho CRM, navigation allows easy movement between the records; it provides options to choose the number of records to be displayed in one page ...Email configuration for Microsoft Graph API
This option is currently being rolled out in phases and may not yet be available in your account. Users can integrate their mailbox with Zoho CRM securely to bring email conversations into the context of customer records. Users of Outlook/ Office 365 ...Deactivating extensions and migrating components with deprecated API name notations
Frequently Asked Questions Why am I receiving this email or notification? There are one or more extensions and components (listed in your CRM login at Setup > Marketplace > All > Deprecated) in your Zoho CRM Organisation, which currently use the ...Troubleshooting IMAP & POP3 Configuration
Password/Basic Authentication Errors (Zoho Mail, Yahoo) During the IMAP/POP3 configuration, there is an error message that says "Authentication Failure for <email id>" or "Invalid credentials" There are multiple reasons why you might see this error: ...
New to Zoho LandingPage?
Zoho LandingPage Resources