Fix errors in flows

Fix errors in flows

How to identify the cause of a problem

Zoho Flow lets you access the history of all flow executions in your organization as well as individual flows. To view an organization-wide history, navigate to Settings History. To view a particular flow's history, navigate to My Flows, then to the required flow, and click History.

Further details of a flow execution can be accessed by clicking on a record. You will see the data exchanged between the trigger and the actions in that flow in a JSON or XML structure. In most cases, this data can help you identify the source and the cause of the problem.

General troubleshooting steps

If a flow fails, or if you are facing a problem with a flow's execution, follow these steps:

  1. Perform the basic checks to see if your flow is configured correctly. For example, check if the flow is switched on, the app connections are made to the intended accounts, and so on.
  2. Navigate to the flow's history. Identify the step that failed and the subsequent error message displayed in the error tab.
    Note: If the error tab is displayed without the input tab, check that step for data mapping related errors such as an invalid data type, incorrect formula formatting (for example, you may have entered "${" instead of ${}), etc.
  3. Try to determine whether the error message is from the application or the Zoho Flow platform.
    For example, if the error message starts with the action app's name, say, "Zoho Mail says...", it means the error is coming from the API, and is application-related.
  4. Cross-check the error message with the configuration of that particular step. In case of data or configuration-related errors, find the input variable that is causing the issue and trace back to the step from which it is mapped. If it is a 'Fetch' action that uses a value from the previous step to fetch a record, check the previous step also.
  5. Reconfigure the trigger or the action that is causing the error. Sometimes, you may need to add decision blocks or custom functions to arrive at the desired result.

You can check the following section for the most common errors and their solutions. If none of these works, please write to us at, and be sure to enable Support Access in advance to help us resolve your issue faster.

Common errors and their fixes 

"Mandatory field is empty" errors

Mandatory fields are very common in actions and will require you to either enter data or select an option to perform that step. If that required field is left empty, you are likely to get an error. You might also see "400 Bad request" in the error message.

Solution: Check the configuration of the concerned step for mandatory fields and insert data into them. 

If the error message says "401 Unauthorized", or contains words like "Authentication failed", it might be due to a connection issue. You may have changed a password, or Zoho Flow's access was revoked.

Solution: Test your app connection, or reconnect your app to Zoho Flow, then try again.

Date formatting and data type mismatch errors

If the error statement contains phrases like "pattern mismatch" or "invalid data type", this might be due to an incorrect variable mapped to a particular field. For example, a variable that holds a string value should not be mapped to a field that expects an integer value.

When it comes to date formats, different apps communicate date and time values in different ways. If the date format passed on from one app doesn't match the date format expected by another app, it will result in an error. 

Solution: Check the variables and their data type when you map it to a field. You can see the data type of a variable right next to it in the Insert Variable section.

When you build flows, you need to ensure that date-time values are converted accurately. This minimizes errors in your flow and ensures that the right values are conveyed to other apps. Learn more

Syntax error due to unsupported language 

Zoho Flow only supports English characters and numbers for field labels. If you try to pass a variable that has other language field labels, it might throw an error that says 'Syntax error'. However, the values that these variables hold and pass can be of any language.

Errors with HTTP status codes: Handled by Auto Rerun

A host of internal and third-party application-related errors (for example, 408 Request timed out, 504 Gateway timeout, etc) are automatically rerun by Zoho Flow's Auto Rerun feature. You can check the list of errors here.

App-specific errors with HTTP status codes

Sometimes, you may encounter errors with HTTP status codes specific to the applications that you are using in your flow. It might be due to a problem in the app's settings or configuration, its servers, or your Zoho Flow connection. In such cases, you might need to pinpoint the exact reason for that error in order to fix the issue. You can follow these steps:
  1. Search for "<app name> API documentation" in a search engine, say Google. For example, Zoho CRM API documentation or Asana API documentation.
  2. Click on the API documentation page of the required app.
  3. Use the 'Find' tool in your browser and look for a section named "Errors" or "HTTP Status code".
  4. You may also directly search for the error code that appeared in your flow's task history. 
For example, suppose when running a flow that has a Zoho Books action, you get an error message with the code "401". You can then follow the above mentioned steps to find the Errors section in Zoho Books API Documentation page. 

From the description provided, it can be deduced that the problem is with the AuthToken in your Zoho Books connection. To solve this issue, you can reconnect your existing connection and try again.

Most apps will provide error codes and their meanings in their API documentation page. You can use this information to try and solve the issue on your own. If you encounter any difficulties, please feel free to contact

Other errors with HTTP status codes

400 Bad Request

A trigger or action may be missing a mandatory step.

Solution: Check that all mandatory fields are correctly set up.

401 Unauthorized

This indicates that there is a connection issue such as a changed password or an access token expired or revoked.

Solution: Reconnect your app connection in Zoho Flow.

403 Forbidden

This likely means that the app account you have connected is denying permission for Zoho Flow to complete a particular step.

Solution: If you are the account admin of the required app, check if you have provided the necessary permissions to complete the concerned step. Otherwise, contact the app account administrator.

404 Not found

This might indicate that a field, a record, or information that is required to complete the step is not found in the connected app. For example, if you have set up an action to update a contact detail but the contact ID doesn't match any records in that app.

Solution: Check that the fields are mapped correctly, and that the records exist in the connected app.

405 Method not allowed

This could mean that the action method (Create, Update, Fetch, and Delete) is not allowed by the connected app.

Solution: Contact the Zoho Flow support at

The above-listed status code errors are the most commonly occurring errors. There are various other status code errors as well, for which you can check the required app's API documentation or contact Zoho Flow support.

    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

            Get started with Zoho Sign

            in a few quick steps!

            Download Help Guide

                      Still can't find what you're looking for?

                      Write to us:



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

                                                  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

                                                                                    • Manage Your flows

                                                                                      Every time you log in to Zoho Flow, you will land on the My Flows page, where all of the flows in your organization will be available. From here, you can: Create flows Filter and search for flows Switch on/off flows Delete flows Create copy of flows ...
                                                                                    • Zoho Recruit

                                                                                      What is Zoho Recruit? Zoho Recruit is an applicant tracking system that helps staffing agencies and recruiting departments track job openings, resumes, candidates, and contacts more quickly and efficiently. You can customize and categorize your ...
                                                                                    • Zoho Books

                                                                                      What is Zoho Books? Zoho Books is online accounting software to manage your accounting, inventory and to file your GST returns. You can manage your contacts, set up rules to categorize banking transactions, make informed decisions based on accurate ...
                                                                                    • Zoho Inventory

                                                                                      What is Zoho Inventory? Zoho Inventory is an inventory management software application that lets you manage all your orders. You can manage your contacts, bills, and reports, and generate invoices easily. How to connect your Zoho Inventory account to ...
                                                                                    • Outlook

                                                                                      What is Outlook? Outlook is email software that lets you manage contacts, set reminders, and share calendars with coworkers. How to connect your Outlook account to Zoho Flow Select the trigger or action required. If you select a trigger, click Next. ...
                                                                                    Wherever you are is as good as
                                                                                    your workplace



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


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


                                                                                      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