Find user role IDs with Harvest API

This article is intended for developers who are working on an integration and need to extract an organization's user_role_ids to assign specific Job Admin permissions to Greenhouse Recruiting users. You can use Greenhouse Recruiting's Harvest API to retrieve a full list of your organization's Job Admin levels with the endpoint GET: List user roles.

Example request:

curl -X GET \
-H 'Authorization: Basic *******' \

Example response:

"id": 4730,
"type": "job_admin",
"name": "Standard"
"id": 4731,
"type": "job_admin",
"name": "Private"

The user role IDs returned can be used to assign Job Admin permissions for individual jobs via the Harvest API endpoint PUT: Add a Job Admin permission. For assigning future Job Admin permissions by office or department you'd want to use the Harvest API endpoint PUT: Add a Future Job Admin Permission.

Additional resources