Skip to main content

​
Overview

Pull data from Greenhouse Harvest API (Candidates, Applications, Job Posts, Scorecards, Rejections) → analyze with Mavera (Personas, Focus Groups, Mave Agent, Generate) → get persona-validated talent brand insights for recruiting, employer branding, and people-ops teams.
Greenhouse Harvest API — Base URL: https://harvest.greenhouse.io/v1. Auth: HTTP Basic (API key as username, blank password) for v1/v2, or OAuth 2.0 for v3. Rate limits: 50 requests / 10 seconds. Pagination via per_page + page query params or Link header.

​
Prerequisites

1

Greenhouse API key

Create a Harvest API key in Greenhouse → Configure → Dev Center → API Credential Management. Grant Candidates, Applications, Jobs, Scorecards, and Rejection Reasons permissions.
2

Mavera API key

Get your key from Mavera dashboard.
3

Environment variables

​
Jobs

​
Rate Limits & Production Notes

Greenhouse counts every request against the 50/10s window regardless of endpoint. Scorecard-heavy jobs (Job 3) can hit this quickly when iterating over hundreds of applications. Add a 250ms delay between scorecard fetches or use webhooks for real-time scorecard data.
Checklist:
  • Store GREENHOUSE_API_KEY in a secrets manager — never commit
  • Use HTTP Basic auth: API key as username, empty password (key: → base64)
  • Paginate with per_page + page or follow the Link response header
  • Retry on 429 using the Retry-After header value
  • Monitor Mavera credits at Dashboard
  • For v3 (OAuth 2.0): use the token exchange flow for user-context access

All Integrations

Greenhouse API

Personas

Focus Groups

Mave Agent

Generate