Connecting JobCannon to Greenhouse

JobCannon integrates with Greenhouse via the official Assessment Partner API. This guide walks you through credential provisioning, sandbox testing, and production deployment.

Quick Reference

Prerequisites

Step 1: Request JobCannon Credentials

Email [email protected] with:

JobCannon will provision Basic Auth credentials within 24 hours.

Example request (do not send this — use your email client)

To: [email protected]

Subject: JobCannon + Greenhouse Integration Setup

Org Name: Acme Inc

Greenhouse Account: [your-id]

Primary Email: [email protected]

Preferred start: sandbox

Thanks,

John Recruiter

Step 2: Configure in Greenhouse

1. **Log in to Greenhouse** as an admin

2. **Navigate:** Settings → Integrations → Assessment Partners

3. **Click "Add Assessment Partner"**

4. **Fill in the form:**

- Partner name: JobCannon

- API endpoint: https://api.jobcannon.io/greenhouse/send_test

- Response error endpoint: https://api.jobcannon.io/greenhouse/response_error

- Basic Auth username: [provided by JobCannon]

- Basic Auth password: [provided by JobCannon]

- Sandbox mode: Check if using sandbox credentials

5. **Click Save**

Greenhouse will test the connection by making a HEAD request to your API endpoint. If the test succeeds, the integration is active.

Step 3: Configure Assessment Delivery

Once the partner is registered, you can assign JobCannon assessments to job stages.

1. **Open a job** in Greenhouse

2. **Go to the stage** where you want to use an assessment (e.g., "Phone Screen")

3. **Click "Add Step"** → Assessment

4. **Select JobCannon** from the Assessment Partner dropdown

5. **Choose a test** from the list (e.g., Big Five, DISC, EQ)

6. **Configure delivery:**

- Send method: Automatic (on stage entry) or Manual (recruiter-triggered)

- Email template: Use JobCannon default or customize co-branding

- Due date: Set a deadline (e.g., 3 days)

7. **Save**

Step 4: Run a Sandbox Test

Before going live, test the full cycle with sandbox credentials.

1. **Create a test candidate** in the job

2. **Advance the candidate** to the stage with the JobCannon assessment

3. **Greenhouse sends a test_send event** to your JobCannon sandbox endpoint

4. **JobCannon emails the test candidate** with a sandbox assessment link

5. **Complete the assessment** in your browser (use a dummy email)

6. **JobCannon scores the response** (sub-1s) and PATCHes the callback URL

7. **Check Greenhouse:** The candidate scorecard should show the assessment score

If the PATCH callback fails, check the response_error endpoint logs in your JobCannon admin panel.

Step 5: Go Live

Once sandbox testing passes:

1. **Request production credentials** from [email protected]

2. **Update Greenhouse integration settings** with production credentials

3. **Toggle sandbox mode OFF**

4. **Send one more test** to a real candidate to confirm end-to-end flow

5. **Monitor callback delivery** in your JobCannon admin for the first week

Common Errors

Error: "Invalid Basic Auth credentials"

**Cause:** Username/password mismatch in Greenhouse settings.

**Fix:**

1. Check the credentials provided by JobCannon (exact copy-paste)

2. Verify no trailing spaces or newlines

3. Re-test in Greenhouse integration settings

4. If still failing, email [email protected] to re-provision

Error: "Callback PATCH failed (502 Bad Gateway)"

**Cause:** JobCannon API is temporarily unavailable or misconfigured.

**Fix:**

1. Check JobCannon service status: https://status.jobcannon.io

2. Verify the callback URL in your JobCannon admin matches the callback_url Greenhouse provided on test_send

3. Wait 10 minutes and retry (auto-retry will run with exponential backoff: 10min → 30min → 2h → 6h)

4. Email [email protected] with the candidate ID and test name

Error: "test_send payload missing required field: test_slug"

**Cause:** Greenhouse sent a malformed request (rare).

**Fix:**

1. Verify you selected a test from the JobCannon list (not a custom text field)

2. Re-create the assessment configuration on the job stage

3. Test again with a new candidate

Error: "Candidate email bounced (invalid recipient)"

**Cause:** The candidate's email in Greenhouse is invalid.

**Fix:**

1. Check the candidate record in Greenhouse for typos

2. Update the email address

3. Re-send the assessment from the Greenhouse candidate page

Verification Checklist

Rate Limits and Quotas

Limits are soft until you exceed 2x the sustained rate. JobCannon will notify [email protected] before hard-throttling.

EEOC and Adverse Impact

The JobCannon catalog includes an Integrity scale and Social Desirability scale for candidate screening (anti-faking). For adverse-impact analysis:

1. **Download EEOC Data File** from your JobCannon admin (/admin/eeoc)

2. **Use the 4/5ths rule:** If selection rate for protected group is <80% of majority group, investigate bias

3. **Reference validity documentation:** JobCannon provides peer-reviewed evidence for each test

See the /docs/integrations/greenhouse/score-mapping guide for the result envelope structure and how to interpret dimensions.

Next Steps

---

**Vendor docs:** https://developers.greenhouse.io/assessment-partner-api.html

**Status page:** https://status.jobcannon.io

**Support:** [email protected]