How to Connect Greenhouse to an AI Agent
Auth setup
1. Go to Greenhouse > Configure > Dev Center > API Credential Management. 2. Create Harvest API key. 3. Use as username in Basic auth (empty password).
Key facts
| Base URL | https://harvest.greenhouse.io/v1/ |
|---|
| API version | v1 (Harvest API) |
|---|
| Auth | Basic auth with API key. Key as username, empty password. Generate at Greenhouse > Configure > Dev Center. |
|---|
| Request body | application/json |
|---|
| Pagination | page-based: per_page (max 500) and page params. Link header for next page. |
|---|
| Rate limit | 50 req/10 sec. HTTP 429 with Retry-After. |
|---|
| Error format | JSON: {"errors":[{"message":"...","field":"..."}]} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /candidates | List candidates |
GET | /applications | List applications |
GET | /jobs | List open jobs |
POST | /candidates | Create candidate |
Quickstart
GET /v1/candidates?per_page=100
Authorization: Basic {base64(api_key:)}
Agent pitfalls & tips
- Harvest API for data access, Job Board API for public job listings.
- Basic auth: API key as username, empty string as password.
- Per-page max is 500 — use for bulk data retrieval.
- Custom fields are returned but vary per company configuration.
- Webhook subscriptions for candidate and application events.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is Greenhouse's AEO score?
▼
Greenhouse has an AEO score of 0.60 and is rated BBB (Basic agent connectivity available). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is Greenhouse AI-agent-ready?
▼
Greenhouse is currently connectable for AI agent use. API access is available but no dedicated MCP server has been published yet. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does Greenhouse compare to other HR & People services?
▼
In the HR & People category, Greenhouse is rated BBB. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how Greenhouse compares.
How can I integrate Greenhouse with an AI agent?
▼
The fastest way to integrate Greenhouse with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with Greenhouse?
▼
Basic auth with API key. Key as username, empty password. Generate at Greenhouse > Configure > Dev Center. Setup: 1. Go to Greenhouse > Configure > Dev Center > API Credential Management. 2. Create Harvest API key. 3. Use as username in Basic auth (empty password).
What are Greenhouse's API rate limits?
▼
50 req/10 sec. HTTP 429 with Retry-After.