Greenhouse vs Zoho Recruit

Greenhouse

Harvest v3 pairs per-endpoint OAuth scopes with Markdown docs that embed an OpenAPI 3.1 definition for each call, and the beta MCP server blocks every DELETE. Access needs a paying customer account, with no public price, trial or self-serve sandbox, and no numeric rate limit or idempotency key was found in the reviewed documentation.

Zoho Recruit

OAuth scopes narrow to one module and one operation, the docs have an llms.txt index with a Markdown page per endpoint, and the Free edition includes 5,000 API credits a day. No OpenAPI description, official SDK, SLA or dated API changelog was found, and the documented token refresh puts the client secret in the URL.

Greenhouse

1. Request a token from https://auth.greenhouse.io/token with client credentials, then send it as a Bearer token to https://harvest.greenhouse.io/v3. Tokens expire, so repeat on 401
2. Put filters and per_page on the first list request only. A cursor must be the only query parameter, or the call returns 422
3. Send the current stage as from_stage_id when moving an application. It guards against stale moves. Other writes have no idempotency key, so check before retrying
4. Read X-RateLimit-Remaining on every response and wait for Retry-After on 429. The window is 30 seconds
5. Expect empty list results or 403 unless the token's user is a Site Admin with the needed permissions

Zoho Recruit

1. Use the api_domain returned with the token, or the regional host (recruit.zoho.com, recruit.zoho.eu, recruit.zoho.in and others). Tokens from one data centre fail on another
2. Send Authorization: Zoho-oauthtoken <token> and refresh hourly. Put refresh parameters in the POST body, not the URL
3. Pass fields on list calls and page with page and per_page (200 at most) until more_records is false
4. Create through /{module_api_name}/upsert with duplicate_check_fields so a retry updates instead of duplicating
5. Move a candidate with PUT /{module_api_name}/status, not upsert. Pass trigger: [] on writes to skip workflows, approvals and blueprints