Namely is a cloud-based Human Resource Information System (HRIS) that helps your organization manage and streamline compliance, record keeping, payroll, benefits, etc... Greenhouse Onboarding has build an integration with Namely that enables your organization to push employee profiles into Namely for easy account creation. In this article, we will cover how to:
- Retrieve Namely Subdomain and Access Token
- Enable Greenhouse Onboarding and Namely Integration
- Mapped Fields between Greenhouse Onboarding and Namely
- Export Employee Profile
Note: Greenhouse Onboarding's integration with Namely is a non-customizable one-way sync of information.
Retrieve Namely Subdomain and Access Token
You will need to retrieve two data points from Namely to enable the integration in Greenhouse Onboarding:
- Access Token
Note: We recommend that the Owner of your Namely account retrieve these two data points from your Namely account.
Navigate to your Namely account and locate your subdomain from within the URL. Your organization's subdomain for your Namely account is the alphanumeric information the precedes namely.com in the URL (e.g. In the example below, the subdomain is greenhouse-sandbox)
Copy down your organization's subdomain.
Next, click the User icon in the upper right-hand corner of your Namely account and select API from the dropdown menu.
From the API page, click Personal Access Tokens and use the provided field to input the name.
Click Create when finished.
Note: We suggest giving the personal access token a recognizable name that illustrates the token is for the Greenhouse Onboarding integration.
Your newly created Personal Access Token will be displayed in the subsequent panel. Copy the Personal Access Token.
Note: Your new Personal Access Token will only be displayed this one time.
Enable Greenhouse Onboarding and Namely Integration
Contact your Greenhouse Onboarding Customer Success Manager (CSM) to enable the Namely option for your organization.
Once the Namely integration option is available in your account, click Settings from your navigation bar and select Integrations from the left-hand panel.
Navigate to the Namely integration and input the copied down Personal Access Token and Subdomain in the provided fields.
Click Save when finished.
Your Greenhouse Onboarding and Namely integration is now enabled for your organization.
Mapped Fields Between Greenhouse Onboarding and Namely
The following Greenhouse Onboarding fields will be mapped and exported to the corresponding field in Namely:
|First Name*||Job Title||Marital Status||Preferred Name|
|Last Name*||Employment Type (Employment Status)||Personal Email||Reports to|
|User Status*||DOB / Date of Birth||Emergency Contact||Address|
|Start Date*||Social Security Number||Emergency Contact Phone||Ethnicity|
|Email*||Gender||Emergency Contract Relationship||Salary|
*Required field to create Namely employee account
Note: Greenhouse Onboarding cannot add or remove mappings from this schema. Currently, the integration does not support the Greenhouse Onboarding fields: Department and Location.
In order to successfully export data from a single select Greenhouse Onboarding field to a single select Namely field, both systems will need to have the same available options for the field.
Export Employee Profile
Once the Greenhouse Onboarding integration is enabled for your organization, you can export an employee profile into Namely directly from the employee profile.
Use the provided search bar to navigate to an employee profile and click Integrations.
Select Export to Namely.
Note: Since every organization defines it's onboarding process differently, employee data can only be exported manually from Greenhouse Onboarding. Additionally, this export can only be performed once in Greenhouse Onboarding so please re-confirm the details of the export before proceeding.
If successful, the integration will provide the following information:
- User who exported the employee data into Namely
- When the export was performed
- A Namely generated ID for the export
- A URL to the candidate's profile in Namely