Recruitee Integration
How to Integrate Testlify with Recruitee
This help article guides you through the process of integrating Testlify with Recruitee. By following these steps, you can set up an automated system for inviting candidates to assessments directly through Recruitee.
Please review this quick video guide-
Overview
This guide explains how to integrate Recruitee with Testlify. The integration allows you to:
- Sync job roles from Recruitee
- Automatically send assessment invites
- View candidate scores directly
Prerequisites
Before starting, ensure you have:
- Access to Testlify
- Access to Recruitee Admin Panel
- Permissions to create:
- Webhooks
- API tokens
Part 1: Workspace-Level Integration
Step 1: Navigate to Integration Settings (Testlify)
- Log in to Testlify
- Go to Settings
- Click on Integrations Module
- Select Recruitee Integration

Step 2: Collect Required Details from Recruitee
You will need the following:
- Company ID
- Personal API Token
- Webhook Secret Key

Step 3: Create Webhook in Recruitee
- Log in to Recruitee
- Go to Settings
- Click on Apps & Plug-ins
- Select Webhooks
- Click Create New Webhook


Fill the following details:
- Webhook Name: (Any name as per your reference)
- Post URL: Contact Testlify Support to get this URL

⚠️ Important:
You must use the Post URL provided by Testlify Support.
- Select “Move on Pipeline” option
- Click Verify & Create


Step 4: Save Webhook Secret Key
- After creation, a Webhook Secret Key will be generated
- Copy and store it securely
- This will be required in Testlify

Step 5: Get Company ID & API Token
- Go to Personal API Token section
- Click Create New Token
- Enter a Token Name
- Click Save



You will get:
- Personal API Token
- Company ID (visible in the same section)

Step 6: Configure Integration in Testlify
Enter the following details in Testlify:
- Company ID
- Personal API Token
- Webhook Secret Key
Click Save
Step 7: Generate Integration Key (Testlify)
- Go to Settings
- Click on Integration Key
- Create a new Integration Key
- Copy and store it securely for future use

✅ Workspace-level integration is now complete
Part 2: Assessment-Level Integration
Step 1: Create or Edit Assessment
- Go to Create Assessment
- Open Settings
- Navigate to Integration Tab

Step 2: Link Recruitee Integration
- Click Link Button
- Select ATS Dropdown
- Choose Recruitee Integration

Step 3: Select Job Profile
- Available jobs from Recruitee will appear
- Select the required Job Profile
Step 4: Configure Invitation Stage
- Select Invitation Stage
- Define when candidates should receive the assessment
Example:
- If stage = Phone Screen
- Candidate moved to this stage → Assessment invite is triggered
Step 5: Save Configuration
- Click Save to complete setup
Step 6: Once a candidate completes the assessment on Testlify:

How It Works (End-to-End Flow)
- Candidate is moved to a configured stage in Recruitee
- Testlify automatically sends the assessment invite
- Candidate completes the assessment
- Scores are available on both platform
Important Notes
- Ensure webhook URL is correctly configured
- Keep API Token and Secret Key secure