Greenhouse · OAuth Scopes

Greenhouse OAuth Scopes

OAuth 2.0 searched

Greenhouse publishes 6 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Greenhouse API on a user’s behalf.

Tokens are issued from https://api.greenhouse.io/oauth/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

ATSRecruitingCandidatesJobsOnboardingHR

Scopes: 6 Flows: authorizationCode Method: searched

OAuth endpoints

Authorization URL
https://api.greenhouse.io/oauth/authorize

Token URL
https://api.greenhouse.io/oauth/token

Flows
authorizationCode

Scopes (6)

Scope	Description	Flows
candidates.create	Create new candidates or prospects.
candidates.view	View candidates imported via this partner.
jobs.view	View my jobs.
prospect_pools.view	Retrieve prospect pools and their stages for an organization.
harvest:candidates:list	List candidates via the Harvest API v3 (example scope named in the Harvest partner OAuth guide).
harvest:job_posts:list	List job posts via the Harvest API v3 (example scope named in the Harvest partner OAuth guide).

📄 Provider scope reference: https://developers.greenhouse.io/candidate-ingestion.html

Source

OAuth Scopes

generated: '2026-07-11'
method: searched
source: openapi/greenhouse-ingestion-openapi.yml
docs: https://developers.greenhouse.io/candidate-ingestion.html
note: >-
  The Candidate Ingestion API documents four OAuth permission scopes (they do not apply
  when authenticating via Basic Auth). The Harvest API v3 also uses granular OAuth scopes
  in the pattern harvest:<resource>:<action> (via auth.greenhouse.io), but Greenhouse
  publishes no complete public list; only the two example scopes named in the Harvest
  partner OAuth guide (https://harvestdocs.greenhouse.io/docs/harvest-partner-oauth)
  are recorded here.
schemes:
- name: oauth2
  source: openapi/greenhouse-ingestion-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://api.greenhouse.io/oauth/authorize
    tokenUrl: https://api.greenhouse.io/oauth/token
scopes:
- scope: candidates.create
  description: Create new candidates or prospects.
  sources:
  - https://developers.greenhouse.io/candidate-ingestion.html
- scope: candidates.view
  description: View candidates imported via this partner.
  sources:
  - https://developers.greenhouse.io/candidate-ingestion.html
- scope: jobs.view
  description: View my jobs.
  sources:
  - https://developers.greenhouse.io/candidate-ingestion.html
- scope: prospect_pools.view
  description: Retrieve prospect pools and their stages for an organization.
  sources:
  - https://developers.greenhouse.io/candidate-ingestion.html
- scope: harvest:candidates:list
  description: List candidates via the Harvest API v3 (example scope named in the Harvest partner OAuth guide).
  sources:
  - https://harvestdocs.greenhouse.io/docs/harvest-partner-oauth
- scope: harvest:job_posts:list
  description: List job posts via the Harvest API v3 (example scope named in the Harvest partner OAuth guide).
  sources:
  - https://harvestdocs.greenhouse.io/docs/harvest-partner-oauth