Working with Connections
Overview
Connections let you integrate Zoho WorkDrive with third-party or Zoho services using OAuth 2.0 authorization. WorkDrive manages the entire OAuth flow, including authorization, access tokens, refresh tokens, and secure storage. This keeps your Deluge functions simple and secure.
Once a Connection is created and linked to your account, you can call external APIs inside Custom Functions by referencing the Connection’s link name. You do not need to manage tokens or store credentials manually.
Creating a Connection
You can create a new Connection from scratch (custom service) or use one of the default services provided by WorkDrive.
To create connection using default services
- Sign in to your WorkDrive account.
- Go to Admin Console > Connections.
- Click Create Connection. The Default services tab will appear by default.
- Choose a service from the list (for example, Slack).
- Provide a Connection Name.
- Select the required scopes specified by the service.
- Click Create and Connect. Complete the authorization process by signing in to the service.
After the Connection is created, WorkDrive displays:
- Link name
- Service name
- Connection status
- Sample Deluge code snippet to invoke the connection
The Connection appears in the My Connections list and can be reused across custom functions.
To create connection using custom services
If your required service is not listed under Default Services, you can configure it manually. After configuration, you or anyone in your organization can create multiple connections for that service by providing the necessary credentials.
Note: Zoho WorkDrive APIs use OAuth 2.0 authentication. You must register your client app with Zoho. Refer to the help documentation to learn how to register your client app and create a custom service.- Sign in to your WorkDrive account.
- Go to Admin Console > Connections.
- Click Create Connection.
- Select Custom Service if your service is not listed. Service details dialog box will appear.
- Provide a name for the service to be connected (ex: MailChimp).
- Select the type of Authentication that is supported by the third-party application or service.
- Enter the service details:
- Client ID
- Client Secret
- Request Token (Authorize) URL
- Access Token URL
- Refresh Token URL (if applicable)
- Provide a Connection Name.
- Enter the Scopes specified by the third-party service. Scope for each connection is given by the third-party service. Please check the help for the respective third-party service to know about their provided scopes.
- Click Create and Connect. Complete the authorization process by signing in to the external service.
Once the Connection is created, it appears in the My Connections list and can be reused across custom functions.
Using a Connection in Custom Functions
The My Connections tab contains the list of available connections that are ready to use. You can select an existing connection or select the one that you created from the Custom Services tab. The connections are to be used by invoking them within functions. You can then use it directly inside a custom function to call external APIs.
To use a Connection:
- Go to Admin Console > Connections.
- Choose the Connection from the My connections section.
- Click Connect if you haven’t already authorized it.
- Copy the sample Deluge code displayed at the bottom of the Connection details page.
- Use this code inside your custom function to perform GET, POST, PUT, or DELETE calls.
- In Deluge, a Connection is invoked using its link name. You can pass parameters to replace dynamic values within the API URL or request body.
Sample connection
Suppose you want to send a notification to Slack every time a file is added to a specific Team Folder.
Step 1: Configure the Slack Connection
- Select Slack from the Default Services tab.
- Create a Connection with the required scopes.
- Authorize the connection.
Step 2: Use the Connection
- Get the link name from the Connection details page.
Step 3: Write a Custom Function
- Invoke Slack’s API using the connection link name to send a message.
- This lets your WorkDrive workflow automatically push real-time updates to Slack without any manual intervention.
Also read:
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
Working with Custom Functions
Overview Custom Functions extend WorkDrive workflows by enabling advanced automation that goes beyond default workflow actions like share, move, copy, update fields, or restrict access. With Custom Functions, you can: Run Deluge scripts to automate ...Track live-user activity in MS Office files using WorkDrive Collaboration Widget
Team members often collaborate and work on the same document simultaneously from different devices. However, in some cases, this can result in file duplication and conflicting versions. Wouldn't it be easier if, while using Desktop Sync or TrueSync, ...Pin important Team Folders for quick access
Pinning a Team Folder keeps your most important workspaces conveniently at the top of your Team Folders list, ensuring quick and easy access, especially when you’re working across multiple Team Folders. To pin a Team Folder Navigate to the left ...Upload large files in chunks
WorkDrive improves the process of uploading large files by breaking them into smaller segments or chunks and uploading them individually. This enhances the upload experience and reduces the challenges often associated with large file uploads. Now, ...How to fix low disk-space issues to use Desktop Sync
The Desktop Sync app for Zoho WorkDrive makes working offline and syncing to multiple devices seamless and convenient, but low disk space in your hard drive may prevent you from using the app or syncing new files. Let's look at how you can fix these ...
New to Zoho LandingPage?
Zoho LandingPage Resources