Greenhouse integration
Add assessment depth to your Greenhouse
skaills plugs into Greenhouse via the public Harvest and Ingestion APIs. No changes on your side. No disruption to your recruiters' funnel. Every candidate entering Greenhouse automatically gets a deep competency profile and a cited AI score.Three ways to integrate
Pick the depth that fits your needs — start light, grow when ready.
Outbound — skaills enriches the candidate in Greenhouse
Planned~2 weeks for the first connector. No Greenhouse-side custom work if the Harvest API key is enabled.
Bidirectional — Greenhouse drives, skaills assesses
Planned~4-6 weeks. Requires Greenhouse-side configuration (Web Hooks, custom fields for our scores, "Assessment" stage).
Greenhouse Marketplace — skaills as certified partner
Roadmap4-6 months including Greenhouse Partner Program certification, security review, listing.
What this looks like in practice
Concrete flows triggered by events in Greenhouse.
| Trigger in Greenhouse | What skaills does | What flows back to Greenhouse |
|---|---|---|
| Candidate applies to a Greenhouse requisition | skaills runs 12-dimension AI CV scoring with cited rationale | Overall score + per-dimension breakdown + PDF appear on the candidate profile in Greenhouse |
| Candidate advances to the "Assessment" stage in Greenhouse | skaills generates an evaluation link tailored to the role profile, sends to candidate, computes psychometric + competency score | Score, ranking vs. other candidates for the role, and structured report come back to Greenhouse as a skaills scorecard |
| Recruiter prepares debrief panel for a final stage | skaills generates calibrated questions per target competency of the role + evaluator guidance | Enriched interview kit appears as attachment on the Greenhouse native Interview Kit |
| Candidate is hired in Greenhouse | skaills auto-creates a 12/24/36-month Personal Growth Plan from the pre-hire evaluation | PGP lives in skaills (the post-hire Transformative layer); Greenhouse Onboarding references the link |
Technical architecture
The integration uses Greenhouse's public APIs: Harvest API (read — candidates, requisitions, stages, scorecards), Ingestion API (write — push assessments and scores), and Web Hooks (stage-change notifications). Authentication via a dedicated API key from your Greenhouse account with minimum scopes (Candidates: read/write; Applications: read; Custom Fields: write). All data transits via HTTPS (TLS 1.2+). Web Hooks land at a dedicated skaills Cloud Function (`greenhouseWebhook`) with HMAC SHA-256 verification of the `Signature` header. skaills doesn't store the Greenhouse API key in plain text; it lives in Secret Manager. All skaills-side logic is serverless.
Implementation timeline
1
Week 1
Define which requisitions are in scope for the pilot, which pipeline stage triggers the skaills evaluation, which custom fields will be created in Greenhouse to receive scores, and which recruiters participate. Identify the project sponsor, the customer-side Greenhouse admin and the assigned skaills team.Kickoff and scope
Deliverable:Scope document signed + Greenhouse Harvest API key issued with minimum scopes
2
Week 2
Create custom fields in Greenhouse (overall skaills Score, per-dimension breakdown, link to report). Configure the Web Hook pointing at our Cloud Function. First end-to-end test with a synthetic candidate: applies → webhook → skaills generates link → evaluation completes → score injects into Greenhouse.Technical setup
Deliverable:E2E test passing with synthetic candidate; custom fields visible on Greenhouse profiles
3
Week 3
Deploy to one real recruiting team, with 10-20 real candidates flowing through. We monitor: evaluation completion rate, latency, perceived score quality by recruiter, lift in advance decision. 15-minute daily standup.Controlled pilot
Deliverable:Pilot report with real metrics and recruiter feedback
4
Week 4
Apply adjustments based on feedback. Internal documentation for your recruiters: how to read the skaills report, how to interpret bias flags, where to verify detail. Handoff session with your Greenhouse admin + Recruiting Ops team. Gradual extension to more teams.Adjustments and rollout
Deliverable:Operational runbook + integration running for all in-scope teams
For Greenhouse Marketplace listing, add another 4-6 months for Greenhouse Partner Program certification and security review.
