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.

    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 Links Workflow Automation Data Collection
                          Web Forms Enterprise Begin Data Collection
                          Interactive Forms Workplace Data Collection App
                          CRM Forms Customer Service Accessible Forms
                          Digital Forms Marketing Forms for Small Business
                          HTML Forms Education Forms for Enterprise
                          Contact Forms E-commerce Forms for any business
                          Lead Generation Forms Healthcare Forms for Startups
                          Wordpress Forms Customer onboarding Order Forms for Small Business
                          No Code Forms Construction RSVP tool for holidays
                          Free Forms Travel
                          Prefill Forms Non-Profit

                          Intake Forms Legal
                          Mobile App
                          Form Designer HR
                          Mobile Forms
                          Card Forms Food Offline Forms
                          Assign Forms Photography
                          Mobile Forms Features
                          Translate Forms Real Estate Kiosk in Mobile Forms
                          Electronic Forms

                          Notification Emails for Forms Alternatives Security & Compliance
                          Holiday Forms Google Forms alternative  GDPR
                          Form to PDF Jotform alternative HIPAA Forms
                          Email Forms
                          Encrypted Forms
                          Embeddable Forms
                          Secure Forms
                          Drag and Drop form builder
                          WCAG


                                            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

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

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

                                                                                                              • 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 ...
                                                                                                              • Understand 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 ...
                                                                                                              • Create and Manage 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 ...
                                                                                                              • Update a form using custom action (from another form's report)

                                                                                                                Requirement   Update a form using a custom action configured in another form's report. Use Case In an engineering college student management application, a student may withdraw at any time of the academic year. Whenever a student applies for ...
                                                                                                              • JS API documentation

                                                                                                                This help page is for users in Creator 6. If you are in the older version (Creator 5), click here . Know your Creator version . Download the latest JS SDK library from the CDN URL given below and link it using the script tag. CDN URL - ...
                                                                                                                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