What is Zoho Flow?

Triggers and actions available for Zoho Directory in Zoho Flow

Triggers

1. User created
   

1. User updated
   

1. User added to group
   

1. User Activated
   

1. User deactivated
   

Actions

1. Create a user
   

 Creates an account for a new user in Zoho Directory. Required details: Organization ID, First Name and User ID, along with personal details.

1. Update a user
   

 Updates the personal details of a user in Zoho Directory. Required details: Organization ID and User ID with personal details.

1. Fetch a user
   

 Retrieves the personal details of an existing user in Zoho Directory. Required details: Organization ID and the User ID or email address of the user.

1. Add a user to group
   

 Adds a user to a group in Zoho Directory. Required details: Organization ID, User ID, Group ID of the group, and the role (Member/Moderator/Follower) the user should have in the group.

1. Activate a user
   

 Activates a user to an organization in Zoho Directory. Required details: Organization ID and the User ID of the user.

1. Deactivate user
   

 Deactivates a user from an organization in Zoho Directory. Required details: Organization ID and the User ID of the user.

Automate your flows between Zoho Directory and other apps using Zoho Flow:

1. Organization Owner
   
2. Organization Admin
   
3. Custom role with the permission to perform the event mentioned in the trigger or action.
   

Assign application

1. Sign in to Zoho Directory and click Admin Panel in the left menu.
   
2. Go to the Applications tab.
   
3. Search and add the Zoho Flow app.
   
4. Click Assign users and assign users who have the above privileges.
   

Create a flow

1. In a new tab, open Zoho Flow.
   
2. In the My Flows section, click Create Flow (top-right) or the + button in the left panel.
   
3. Enter Flow Name and description (optional).
   
4. Click Create to open the Flow Builder screen. You can take a look through the Getting Started screen or skip it.
   
5. In the Builder screen, under App, click Configure.
   

   
   

   
   
   
6. Search and select the required application. Click Next.
   
7. Choose a trigger from the list of triggers, then click Next.
   
8. Click Connect to create a connection between Zoho Flow and the application you have selected. If there are existing connections, you can choose your preferred connection. Or you can also choose to create a new one by clicking New Connection. Once a connection is created, it can be used for various workflows in your organization.
   
   
   
   
9. Click +New, then enter Connection Name.
10. Choose your preference:
    
1. All triggers and actions: The workflow created by this connection can execute all triggers and actions.
   
2. Only specific triggers and actions: The workflow created by this connection can execute only the selected triggers and actions.
   
11. Click Authorize. A new browser window will open where you can review the access permissions.
    
12. Click Accept. Once the connection is established, proceed to choose the required organization.
    
13. Click Done. Now you have configured the trigger for the flow.
    
14. On the left panel, find the app you want to integrate (e.g., Zoho CRM, Zoho Cliq, Zoho Directory, etc.,).
    
15. Drag and drop an Action from the app (e.g., Create Contact, Send Message). Or you can drag and drop an element from LOGIC from the available types- Flow Control, Notification, and Custom Functions. To know more about LOGIC
    
16. Connect the app by granting the necessary permission if asked. Click the edit icon of the action.
    
17. In the configuration screen, you can choose how to provide its value for each field:
    
1. Select from list: You can select a specific data from the drop-down list. For example, to provide value for User ID field, select a user's id from the list and the flow uses that data for further executions.
   
2. Insert App Data: Use dynamic data from the trigger or previous actions. Select the Use a Custom Value for a field, then select the placeholder of Custom Value for field. From the Insert variables section select the appropriate string. The variable is pasted in the placeholder starting with $ symbol (e.g., ${trigger.user.id}
   
3. Enter custom value: Type a fixed value that remains the same for all executions. Select the Use a Custom Value for a field. Below appears a new field named Custom Value for User ID, then enter the value.
   

      

            

Test and Debug

1. Click the Test & Debug icon in the top-right corner to ensure everything works correctly.
   
2. When ready, turn on the flow using the toggle switch at the top-right corner.
   
   
   
   

View Task History of executions

1. Click History next to Builder.
   
2. In the history screen, you can view all the tasks, their execution date, time taken for each execution, and their status:
   
1. Completed: The workflow execution is successful.
   
2. Failed: The workflow execution has failed due to an error.
   
3. Select the execution to view more details. Click Input at the top-right corner to view the data that is processed. Click Output at the top-right corner to view the output data. You will find the errors that caused the failure in the execution. Select the executions that have failed, then click Resume to continue the execution of the workflow from where it stopped or failed, or click Restart to rerun the workflow from the beginning.

Example Flow

Flow 1:

Creating a workflow for when a "User activated" trigger is initiated it results in adding that user to a particular group.

1. In the My Flow section, click Create Flow on the top-right or + on the left panel.
   
2. Add Name and Description. Click Create.
   
3. In the Builder screen, under the App panel, click Configure to set up the trigger.
   
4. Search for and select Zoho Directory.
   
5. Select User Activated trigger and click Next.
   
6. Click Connect, then enter the connection name and click Authorize.
   
7. Click Accept, then click Done.
   
8. Choose Add user to group action from Zoho Directory on the left panel and drop it under the trigger.
   
9. Click the edit icon.
   
10. Click New, then enter Connection Name.
    
11. Click Authorize.
    
12. Then select the Group ID that the user will be added to. Then choose the User ID or click Use a Custom Value to enter a value of your choice.
    

Note: The value you enter in Custom Value fields should be support by the respective actions or it may result an error. 
13. Click Done. 
    
    
    
    
14. Click Test & Debug icon at the top-right to ensure everything works correctly.
    
15. Once testing is successful, toggle the switch at the top-right to turn on the workflow.
    
16. Click History near the Builder to view all past workflow executions.

Flow 2:

1. In the My Flows section, click Create Flow in the top-right corner or the + button in the left panel.
   
2. Enter a Flow Name and description (optional) and click Create.
   
3. In the builder screen, under App, click Configure.
   
4. Search for and select "Zoho Form". Click Next.
   
5. Choose Entry submitted-New Version trigger, then click Next.
   
6. Click Connect. If there are existing connections, you can choose your preferred connection. Or click New Connection. Once a connection is created, it can be used for various flows in your organization.
   
7. Enter Connection Name, then click Authorize. A new browser window will open where you can review the access permissions, then click Accept.
   
8. Select the form to be used, then click Done. Now you have configured the trigger for the flow.
   
9. On the left panel, search for Zoho Directory.
   
10. Drag and drop the Create User action. Connect the Zoho Directory app by authorizing necessary permissions. Click on the edit icon, then map the required fields using app data from the trigger.
    
11. Click LOGIC on the left panel.
    
12. Under Notifications, drag and drop Send Email below the Create User action. Enter the To and From addresses, then draft the email to be sent to the user. You can use required fields using app data from the trigger and actions in the workflow.
    
    
    
    
13. Pick and place the action Message as bot on chat as an error action for Create User. Then connect the Cliq app by authorizing necessary permissions. Map the required fields using app data from the trigger and the actions in this workflow.
    
    Note: Whenever you make changes to actions, click Apply Changes in the top, then click Apply to keep your changes applied to your workflow. 
14. Click the Test & Debug icon at the top-right to ensure everything works correctly.
    
15. Once testing is successful, toggle the switch at the top-right to turn on the workflow.
    
16. Click History near the Builder to view all past workflow executions.