Custom API Status Codes | Zoho Creator Help

Custom API status codes

The success or failure of a custom API request is conveyed by the code and message in its response. The following table lists all the codes corresponding to Zoho Creator's custom APIs.
HTTP Status Code
HTTP Status
Code
Message
Description
403
FORBIDDEN
4000
Account's custom API limit has been reached. Please upgrade to execute more custom API calls.
The custom API could not be executed since the API call limit for the day has been exhausted. This limit will be displayed in the Billing module. The custom API can be invoked after waiting a day, or the account's API call limit can be extended by the super admin.
400
BAD REQUEST
9350
Custom API doesn't exist. Please check the custom API link name.
The custom API link name mentioned in the API request is incorrect or does not exist. The link mentioned here should match the one specified in the endpoint URL of the custom API:
400
BAD REQUEST
9360
Custom API is in draft or disabled state. Please enable the API and try again.
The custom API mentioned in the API request is either in the draft stage or has been disabled. The custom API's configuration has to be complete and enabled before executing the API request.
401
AUTHORIZATION ERROR
9370
The request contains an invalid public key for this Custom API.
The public key used in the API request is incorrect. Ensure that the exact public key from the summary of the custom API's configuration is specified here.
401
AUTHORIZATION ERROR
9380
You do not have permission to invoke this Custom API. Please reach out to the admin.
The user does not have permission to invoke this custom API, as it is restricted to admins of the organization where it was built. The user scope configuration defines which users are authorized to access the API, and it has been set to 'Admin Only.'
401
AUTHORIZATION ERROR
9390
You do not have permission to invoke this Custom API. Please reach out to the admin.
The user does not have permission to invoke this custom API since they have not been included in the user scope. The user scope, configured while building this custom API, defines which users are authorized to access the API.
405
METHOD NOT ALLOWED
9400
The provided HTTP method is not valid for this custom API.
The HTTP method does not match the expected request method with which this custom API was configured. The exact value from the summary of the custom API's configuration must be specified here.
400
BAD REQUEST
9410
The Content-Type specified for this Custom API is invalid.
The content type does not match with this custom API's configuration. The exact value from the summary of the custom API's configuration must be specified here.
500
INTERNAL SERVER ERROR
9430
There is an error while executing Custom API.
The custom API could not be executed since there is an error in the configured Deluge function. Ensure that any such errors are rectified before executing it again.
400
BAD REQUEST
9450
Datatype mismatch encountered. Please provide a valid value for %s.
The value entered for the specified key, '%s', does not match the datatype required for it. The datatype mentioned for the key in the request body should be followed here.
500
INTERNAL SERVER ERROR
9460
The action associated with this custom API does not align with the configurations for Request or Response. Please reach out to the admin.
The actions defined for this API request are not complying with the configured request and response components of the mentioned custom API. This should be checked and verified with the custom API's configuration.
401
AUTHORIZATION ERROR
9470
You do not have permission to invoke this Custom API since you have not accepted the invitation yet. Please check your email or reach out to the admin.
The user who invoked this custom API is restricted from performing that action. This is because they are a pending user in the account where the API was built. When an admin or super admin has added a user to an organization, they are added as a pending user. They have to accept the invitation sent by the admin to become a confirmed user, after which they can invoke this API.
401
AUTHORIZATION ERROR
9480
The specified user does not exist.
The user who has invoked this custom API does not belong to the organization in which it has been created.
401
AUTHORIZATION ERROR
9490
The specified user is currently inactive. To activate, please reach out to the admin.
The user who has invoked this custom API is inactive in the organization in which it was created. They have to be activated by an admin or super admin, after which they can invoke this API.
500
INTERNAL SERVER ERROR
9500
Invalid Custom API configuration. Please reach out to the admin.
The API request could not be executed due to an error in the custom API's configuration. The correctness of the custom API configuration and whether it is ready to be invoked should be checked.
403
FORBIDDEN
9510
Invalid domain name. Kindly use the domain - %s
The custom API could not be executed since the domain mentioned in the endpoint URL is invalid. The endpoint URL must specify the domain as mentioned in the error message.


        Create. Review. Publish.

        Write, edit, collaborate on, and publish documents to different content management platforms.

        Get Started Now


          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 CRM Training
              Redefine the way you work
              with Zoho Workplace

                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 CRM Training

                  Create, share, and deliver

                  beautiful slides from anywhere.

                  Get Started Now


                    Zoho Sign now offers specialized one-on-one training for both administrators and developers.

                    BOOK A SESSION







                                Quick LinksWorkflow AutomationData Collection
                                Web FormsEnterpriseOnline Data Collection Tool
                                Embeddable FormsBankingBegin Data Collection
                                Interactive FormsWorkplaceData Collection App
                                CRM FormsCustomer ServiceAccessible Forms
                                Digital FormsMarketingForms for Small Business
                                HTML FormsEducationForms for Enterprise
                                Contact FormsE-commerceForms for any business
                                Lead Generation FormsHealthcareForms for Startups
                                Wordpress FormsCustomer onboardingForms for Small Business
                                No Code FormsConstructionRSVP tool for holidays
                                Free FormsTravelFeatures for Order Forms
                                Prefill FormsNon-Profit

                                Intake FormsLegal
                                Mobile App
                                Form DesignerHR
                                Mobile Forms
                                Card FormsFoodOffline Forms
                                Assign FormsPhotographyMobile Forms Features
                                Translate FormsReal EstateKiosk in Mobile Forms
                                Electronic Forms
                                Drag & drop form builder

                                Notification Emails for FormsAlternativesSecurity & Compliance
                                Holiday FormsGoogle Forms alternative GDPR
                                Form to PDFJotform alternativeHIPAA Forms
                                Email FormsFormstack alternativeEncrypted Forms

                                Wufoo alternativeSecure Forms

                                TypeformWCAG

                                        Zoho FSM Video Tutorials


                                              All-in-one knowledge management and training platform for your employees and customers.

                                                        Create. Review. Publish.

                                                        Write, edit, collaborate on, and publish documents to different content management platforms.

                                                        Get Started Now




                                                                          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.




                                                                              Manage your brands on social media


                                                                                • Desk Community Learning Series


                                                                                • Digest


                                                                                • Functions


                                                                                • Meetups


                                                                                • Kbase


                                                                                • Resources


                                                                                • Glossary


                                                                                • Desk Marketplace


                                                                                • MVP Corner


                                                                                • Word of the Day


                                                                                • Ask the Experts


                                                                                  Zoho Sheet Resources

                                                                                   

                                                                                      Zoho Forms Resources


                                                                                        Secure your business
                                                                                        communication with Zoho Mail


                                                                                        Mail on the move with
                                                                                        Zoho Mail mobile application

                                                                                          Stay on top of your schedule
                                                                                          at all times


                                                                                          Carry your calendar with you
                                                                                          Anytime, anywhere




                                                                                                Zoho Sign Resources

                                                                                                  Sign, Paperless!

                                                                                                  Sign and send business documents on the go!

                                                                                                  Get Started Now




                                                                                                          Zoho TeamInbox Resources





                                                                                                                    Zoho DataPrep Demo

                                                                                                                    Get a personalized demo or POC

                                                                                                                    REGISTER NOW


                                                                                                                      Design. Discuss. Deliver.

                                                                                                                      Create visually engaging stories with Zoho Show.

                                                                                                                      Get Started Now








                                                                                                                                          • Related Articles

                                                                                                                                          • Understanding custom APIs

                                                                                                                                            This help page is for users in Creator 6. Find your Creator version. 1. What does this page cover Learn about custom APIs and how to define their actions using Deluge functions, which can then be exposed as an API and called from an external ...
                                                                                                                                          • Creating and managing custom APIs

                                                                                                                                            This help page is for users in Creator 6. Find your Creator version. 1. What does this page cover Learn how to create a custom API and authenticate it to integrate with in Zoho Creator. Before moving ahead, click here to learn more about custom APIs. ...
                                                                                                                                          • Handle the error when an incorrect value is inputted by user

                                                                                                                                            Requirement Handle errors that occur when user enters an incorrect value. Use case A company uses Zoho Recruit to maintain interview and candidate details. To let their candidates know their status, the company uses a Zoho Creator form. The ...
                                                                                                                                          • Understanding logs

                                                                                                                                            This help page is for users in Creator 6. If you are in the older version (Creator 5), click here. Know your Creator version. In a nutshell Logs help you monitor user access activity and executions in your Creator applications. This includes ...
                                                                                                                                          • Working with Creator AI Studio in VS Code

                                                                                                                                            Note: This feature is currently in its beta phase. Early access will be available soon. What does this page cover This guide walks you through installing and using Creator AI Studio for VS Code. Once installed, you connect the extension to your Zoho ...
                                                                                                                                            Wherever you are is as good as
                                                                                                                                            your workplace

                                                                                                                                              Resources

                                                                                                                                              Videos

                                                                                                                                              Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                                              eBooks

                                                                                                                                              Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                                              Webinars

                                                                                                                                              Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                                              CRM Tips

                                                                                                                                              Make the most of Zoho CRM with these useful tips.



                                                                                                                                                Zoho Show Resources