Greenhouse Integration
Connect your Greenhouse ATS to automatically send candidates for assessment and receive results back.
If your organization uses Greenhouse, you can connect it to Talent Systems so candidates are automatically sent for assessment when they reach the right pipeline stage — and results flow back to Greenhouse when they're done.
How It Works
A candidate reaches the Assessment stage in your Greenhouse pipeline
Greenhouse sends the candidate to Talent Systems automatically
The candidate receives a link to their assessment — interview, practical, or both
When the candidate completes their assessment, Greenhouse is notified
Recruiters can view scores and results directly from Greenhouse, or click through to the full scorecard in Talent Systems
What You Need
- A Greenhouse account with Assessment Partner integrations enabled
- An API key from your Talent Systems administrator
- At least one active posting in Talent Systems mapped to a Greenhouse job
Setup
1. Get Your API Key
Contact your Talent Systems administrator to generate a Greenhouse API key for your organization. The key starts with gh_ followed by a long string. Keep it secure — it authenticates all communication between Greenhouse and Talent Systems.
2. Configure Greenhouse
In your Greenhouse account, go to Configure > Dev Center > API Credentials and add a new Assessment Partner integration with these URLs:
| Field | URL |
|---|---|
| List Tests URL | https://app.frontstagehire.ai/api/greenhouse/list_tests |
| Send Test URL | https://app.frontstagehire.ai/api/greenhouse/send_test |
| Test Status URL | https://app.frontstagehire.ai/api/greenhouse/test_status |
| Error Notification URL | https://app.frontstagehire.ai/api/greenhouse/response_errors |
Enter your API key when prompted.
3. Map Jobs to Postings
When you add an Assessment stage to a Greenhouse job, you'll see a list of your active Talent Systems postings. Select the one that matches. Make sure the posting is fully configured and active (not draft) before connecting it.
4. Test the Connection
Use Greenhouse's built-in test feature to send a test candidate. Verify:
- The test candidate appears in the posting's candidate list in Talent Systems
- The candidate receives an assessment link
- After completing the assessment, the status updates in Greenhouse
What Happens to Candidates
- Candidates sent from Greenhouse are created automatically in Talent Systems — no manual invite needed
- Greenhouse handles candidate communication, so Talent Systems does not send a separate invitation email
- Candidates appear in your posting's candidate list with all the same features: scorecard, analytics, comparison, export
- If you reset a Greenhouse-sourced candidate, the new link is generated but no email is sent — use Greenhouse to re-notify them
Viewing Results
When a candidate completes their assessment:
| Where | What You See |
|---|---|
| In Greenhouse | Status updates to "Complete" with a score and a link to the full results |
| In Talent Systems | Full scorecard, competency breakdown, recommendation, and transcript |
Troubleshooting
| Issue | Solution |
|---|---|
| Postings not showing in Greenhouse | Make sure the posting is active (not draft) and your API key is valid |
| Candidate not created | Check that the Greenhouse job is mapped to the correct posting |
| Results not appearing in Greenhouse | The assessment may still be in progress — Greenhouse polls for status automatically |
| API key not working | Contact your administrator — the key may have been revoked or rotated |
Managing API Keys
API keys are managed by Talent Systems administrators. Administrators can generate new keys, rotate existing keys (old key stops working immediately), and revoke keys if they are compromised.
If the Assessment Partner integration isn't configured yet, click Request Setup on the integration card. This notifies the Talent Systems team to set up your API key. You'll see a "Requested" badge while it's being processed.