How to use App Connect with Zoho Recruit

Zoho Recruit simplifies the hiring process for recruiters by providing solutions for finding, tracking, and hiring candidates across multiple platforms. It is ideal for both in-house recruiters and staffing agencies.

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to Zoho Recruit

Complete the connection fields that you see in the App Connect Designer Connect > Applications and APIs page (previously the Catalog page) or flow editor. If necessary, work with your Zoho Recruit administrator to obtain these values.

Zoho Recruit has the following authorization types and connection fields.

BASIC OAUTH: Server URL is the URL for the API server that makes runtime calls.; Token base URLis the token URL value relative to the server URL. Select a server URL to use as the base for the token URL.; Application client ID is the unique client identifier to use for authentication.; Application client secret is the unique client secret to use for authentication.; Access token is the access token that is generated from the application client ID and client secret.; Refresh token is the refresh token that is generated from the application client ID and client secret.; Set Allow self-signed certificates to true if you want to be able to accept self-signed certificates that are trusted and used only in a nonproduction environment. The default is false.; Override server URL is required if you want to connect to an endpoint in a private network by using the private network client, or if you want to override the server URL. Specify an override value for the host and port for the connector in the format <http or https>://<host_name>:<port>. If you're not using the private network client or don't need an override, don't enter a value in this field.

OAUTH 2.0 AUTH CODE: Server URL is the URL for the API server that makes runtime calls.
Tip: To determine the domain where you're accessing Zoho Recruit from, go to the Zoho Recruit web app and check the URL. For example, if the URL contains crm.zoho.com, you're accessing it from the .com domain.; Token base URL is the token URL value relative to the server URL. Select a server URL to use as the base for the token URL.
Note: The domain extensions for the server URL and the token base URL must remain the same.

To obtain the connection values for Zoho Recruit, see Obtaining connection values for Zoho Recruit.

To connect to a Zoho Recruit endpoint from the App Connect Designer Applications and APIs page for the first time, expand Zoho Recruit, then click Connect. For more information, see Managing accounts.

Tip:

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

General Considerations

Before you use App Connect Designer with Zoho Recruit, take note of the following considerations:

You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.
For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.
If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.

Events and Actions

Zoho Recruit events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Show more configurable events: Events that are shown by default are pre-configured by using optimized connectivity. More items are available after you configure events that can trigger a flow by polling this application for new or updated objects.

Zoho Recruit actions

Your flow completes these actions on this application.

Object	Action	Description
Candidates	Create candidate	Creates a candidate with the provided information
	Retrieve candidates by advanced filters	Retrieves the list of candidates by using advanced filters
	Update candidate status	Changes the status of an existing candidate
	Retrieve candidates	Retrieves the details of candidates by using filters
	Associate candidates with job openings	Associates candidates with job openings
Job openings	Create job opening	Creates a job opening with the provided information
	Retrieve job openings by advanced filters	Retrieves job openings by using advanced filters
	Update job opening status	Changes the status of an existing job opening
	Retrieve job openings	Retrieves the details of job openings by using filters
Users	Retrieve users	Retrieves users who are allowed to access and manage records
Departments	Retrieve departments	Retrieves all departments with filters
Applications	Retrieve applications	Retrieves all applications with filters
Applications	Retrieve application by record ID	Retrieves details of an application by using record ID

Examples

Dashboard tile for a template that uses Zoho Recruit

Use templates to quickly create flows for Zoho Recruit

Learn how to use App Connect templates to quickly create flows that complete actions on Zoho Recruit. For example, go to the Discover page and search for Zoho Recruit.

Learn more

Use App Connect to build flows that integrate with Zoho Recruit.

Read the blog in the IBM® Community to learn how to create a job opening in Zoho Recruit for job requisitions in SAP SuccessFactors. The blog also explains how to associate candidates with job openings in Zoho Recruit for each new Wufoo form entry. Click Read the blog to go to the blog.

Read the blog