Greenhouse Integration

Connect Telescopic to Greenhouse to automatically send AI literacy assessments when candidates reach a specific interview stage.

⏱️ Setup time: ~10 minutes

Prerequisites

  • Admin access to your Greenhouse account
  • A Telescopic account with API access

Step 1: Create a Greenhouse API Key

  1. Log into Greenhouse as an admin
  2. Navigate to Configure → Dev Center → API Credential Management
  3. Click Create New API Key
  4. Select Harvest API
  5. Name it Telescopic Integration
  6. Grant these permissions:
    • Candidates: GET, POST
    • Applications: GET
    • Jobs: GET
  7. Click Create and copy the API key

Step 2: Configure Telescopic

  1. Go to your Telescopic Dashboard
  2. Navigate to Settings → Integrations → Greenhouse
  3. Paste your Greenhouse API key
  4. Set your trigger stage (e.g., "Assessment")
  5. Click Save

Or use the API:

curl -X POST https://telescopic.ca/api/integrations/greenhouse/config \
  -H "Authorization: Bearer YOUR_TELESCOPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "greenhouseApiKey": "YOUR_GREENHOUSE_API_KEY",
    "triggerStage": "Assessment",
    "enabled": true
  }'

Step 3: Set Up Webhook in Greenhouse

Webhooks notify Telescopic when candidates move between interview stages.

  1. In Greenhouse, go to Configure → Dev Center → Webhooks
  2. Click Create New Webhook
  3. Configure:
    • Name: Telescopic
    • When: Candidate has changed stage
    • Endpoint URL:

📋 Get your webhook URL:

Go to your Telescopic Dashboard → Settings tab → copy the Greenhouse Webhook URL

  1. Generate a Secret Key and save it
  2. Add the secret key to your Telescopic Greenhouse settings
  3. Click Create Webhook

💡 The secret key is used to verify webhook signatures. Keep it secure.

Step 4: Create an Assessment Stage

Add an interview stage that will trigger assessments:

  1. In Greenhouse, go to a job's Job Setup → Interview Plan
  2. Click Add Stage
  3. Name it Assessment (must match your trigger stage)
  4. Position it where you want candidates to take the assessment

Step 5: Test the Integration

  1. Move a test candidate to your Assessment stage
  2. Check that they receive an email with the assessment link
  3. Complete the assessment
  4. Verify results appear on the candidate's Activity Feed in Greenhouse

How It Works

1

Candidate moves to Assessment stage

Recruiter moves candidate in Greenhouse

2

Greenhouse sends webhook to Telescopic

Automatic, happens instantly

3

Candidate receives assessment email

Unique link valid for 72 hours

4

Candidate completes assessment

~15-20 minutes

5

Results pushed to Greenhouse

Appears as note on candidate profile

Results in Greenhouse

After completion, results appear on the candidate's Activity Feed:

🎯 Telescopic AI Literacy Assessment

Overall Score: 🟢 85/100

Breakdown:

  • • Prompt Quality: 🟢 88/100
  • • Context Usage: 🟢 82/100
  • • Iteration Skills: 🟢 85/100
  • • Efficiency: 🟢 84/100

Strong AI collaboration skills demonstrated.

🔗 View Full Results

Troubleshooting

Webhook not firing

  • Verify the webhook is enabled in Greenhouse
  • Check the endpoint URL includes your correct Company ID
  • Ensure the webhook is set to "Candidate has changed stage"

Signature verification failing

  • Confirm your webhook secret key matches in both Greenhouse and Telescopic
  • Make sure there are no extra spaces in the secret key

Results not appearing in Greenhouse

  • Confirm your Greenhouse API key has POST permission for Candidates
  • Check that the candidate ID is correctly stored

Need Help?

Contact us at support@telescopic.ca