In some organizations, an employee ID can be a more stable identifier than an employee's email address or name. Greenhouse Recruiting allows your organization to associate an employee ID with a user's account. 

The employee ID field in Greenhouse Recruiting can be any alphanumeric string that your organization assigns to its employees. Greenhouse Recruiting enforces employee ID uniqueness, so there will be an error message if you attempt to save a pre-existing employee ID used by another user. In this article, we will cover how to:


Add Employee ID to Greenhouse User Profile

To assign an employee ID to an individual Greenhouse Recruiting user profile, click the Configure icon configure.png in the upper-right hand corner and select Users from the left-hand panel.


Select a user profile from the subsequent list.


From the user's profile, navigate to the Employee ID field and input the user's employee ID.

When finished, navigate down the page and click Save.



Add Employee ID to SSO

For organizations using a Single Sign-On (SSO) provider to log into Greenhouse Recruiting, it is possible to add the Employee ID in your SSO provider. By adding employee ID in your SSO provider, the employee ID can be assigned automatically to the user the first time they log into Greenhouse Recruiting.

To configure employee ID with your SSO provider contact our technical support team and they can assist you in the steps during your SSO configuration.


Edit Employee ID via Harvest API

Once employee ID is set up for your organization, it will appear in web hooks and the Harvest API when retrieving lists of users. Additionally, you can make an API call regarding a single user by using only their Employee ID. Check out our updated documentation here to try it out!