Connections is an interface to integrate third party services with your Zoho Service, in this case, Zoho Recruit. These connections are used in an URL invocation task to access authenticated data. To establish a connection, it is necessary to provide a Connection Name, Authentication Type amongst other details.
Steps to integrate Zoho Recruit with a third party service are given below:
- Log in to Zoho Sigma console and click Extensions.
- Select the extension you'd like to modify and click Edit Extension.
You will be navigated to the Zoho Developers console. - Select the extension you'd like to modify and click Edit.
- Click Connections in the left panel of the Extension Details page.
In the All connections page, you'll find two categories :
- Own Connection
- Shared Connection
Own Connection
Connections created by you will be listed under the own connection section.
Shared Connection
Connections created by others and authenticated by you will be listed under shared connection.
Types of Connections
Connections are listed under two sections
- Default - Services listed under the Pick Your Service category are considered as Default Connections.
- Custom - If you would like to create a connection with a service that is not listed under the Pick Your Service category, then you can create a custom connection.
Adding a new connection
Click the Add Connection option in the top right corner of the All Connections page.
- The Pick your Service option contains the list of third party services pre-registered with Zoho Recruit. These connections when used will have the name of Zoho DRE in the third party services.
- You can also select the Custom Service option to create a connection in case the service you are looking for is not available in the pre-registered services list.
Using a Default Connection:
- When the service you want to integrate is available in the Pick your service section, you can use it by just choosing the service and giving a proper connection name. You have to enable the Use credentials of login user option (user access value) to make the connection use the user authentication. In case the option is not enabled, the connection will use the admin (connection owner) authentication.
- Click Create and Connect.
Create a Custom Connection:
In case the service you are looking for is not available in the pre-registered services list, you will have to create a custom connection. This would require you to create and configure settings in Zoho Recruit as well as the third party service.
- To create a custom connection, click the Custom Service option and provide the following.
Service Details
Service Name - Name of the third party service you are building an integration
Authentication Type (Basic / OAuth1 /OAuth 2) - Select the authentication method followed by the respective service
Param Type - Every service will have its way to accept the necessary parameters. Choose the parameter type from either of the following Query String, Form Data, Headers
Connection Details
Connection Name - Your connection name
Scope - Define how and what information can be accessed by the connection
Use credentials of login user - Enabling this option will prompt the user to authenticate the connection using their own credentials. If the option is disabled, then the connection will be authenticated using the connection owner's credentials
Note:
In case of extensions containing connections that work with the owner credentials (disabling the use credentials of login user option), user who installs the extension will be considered as the connection owner. That is, the connection will be authenticated with the credentials of the user who installs the extension.
- Click on Save.
- Upon successful authorization, your connection is created and listed on the connections page.