Set Up the Zoho Recruit Integration with Testlify
This guide covers how to install the Testlify extension in Zoho Recruit, configure the automation webhook, link an assessment, and send it to candidates.
Before you begin
- Administrator access to your Zoho Recruit account
- Administrator access to your Testlify workspace
- Access to Zoho Recruit Marketplace
Part 1: Install the Testlify extension in Zoho Recruit
-
Click Marketplace in your Zoho Recruit account.

-
In the Marketplace search bar, enter Testlify For Zoho Recruit.

-
On the extension page, click Install.

-
Select the checkbox, then click Install Now.
-
Click Agree and Continue.
-
Select Install for all users (recommended), then click Confirm.
Part 2: Authorize the integration
After installation, authorize the extension to activate it.
- Click Authorize.
-
Click Accept.
-
Click Finish.
Part 3: Configure the automation webhook in Zoho Recruit
This is a one-time setup. You need to create a Workflow Rule with a Webhook so that candidate status changes in Zoho Recruit automatically trigger Testlify assessment actions.
Step 1: Navigate to Workflow Rules
- Go to Settings in your Zoho Recruit account.
- Under Automation, click Workflow Rules.
- Click Create Rule.


Step 2: Create a new rule
Fill in the rule details:
- Module: Applications
- Rule Name: TestlifyQA (example)
- Description: QA (example)
Click Next.
Step 3: Set the trigger condition
- Select On a Record Action.
- Choose Change Status.
Click Next.

Step 4: Apply rule criteria
- Select All Applications.
- Click Next.

Step 5: Configure the instant action (Webhook)
- Click Instant Actions.
- Select Webhook.

Step 6: Configure webhook details
Fill in the following:
- Name: Invitation Testlify
- URL to Notify:
https://integrations.testlify.dev/hooks/v1/zoho-recruit/send-assessment-change-status - Method: POST
- Authorization Type: Connection
- Select the appropriate Connection from the dropdown.

Step 7: Add webhook parameters
Add the following parameters:

| Parameter Name | Module | Field Value |
|---|---|---|
| candidateId | Candidates | Candidate Id |
| Candidates | ||
| candidateFirstName | Candidates | First Name |
| candidateLastName | Candidates | Last Name |
| jobId | Job Openings | Job Opening Id |
| clientId | Organization | Organization Name |
| status | Applications | Application Status |
Step 8: Generate preview and save
- Click Refresh to generate the Preview URL.
- Click Save and Associate.
- Click Save.


The webhook rule is now active. Any candidate status change in Zoho Recruit will trigger Testlify and send or update assessments automatically.
Tip: Before going live, verify that the connection is active, all parameters are mapped correctly, and the stage names in Zoho match the stages configured in your Testlify workflow.
Part 4: Connect Zoho Recruit in Testlify settings
-
In Testlify, click Settings.

-
Select Integration from the side panel.

-
Choose Zoho Recruit from the list of integrations.

-
Log in with your Zoho Recruit credentials.

Part 5: Link an assessment to the Zoho Recruit integration
-
Select an assessment and click Edit.

-
Under Setup Assessment, go to Settings and click Integration.

-
Click Add, select Zoho Recruit, choose the Job Role, enter the Invitation Stage and Completion Stage manually, then click Add.

Part 6: Send an assessment to candidates
-
In Zoho Recruit, click Candidates to view your applications.

-
Select a candidate and move them to the next stage (for example, In Review).

-
Once the stage is updated, the candidate receives an assessment invitation automatically. You can also see the invitation in the Testlify platform.

-
When the candidate completes the assessment, they move to the next configured stage (for example, Qualified). After a few minutes, open the candidate's profile in Zoho Recruit, scroll down to Notes, and find the candidate's score and report link.


Need help? Contact support.







