How can we help you?

Namely

owner.png

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:

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:

  1. Subdomain 
  2. 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)

Screen_Shot_2019-02-25_at_11.22.51_AM.png

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.

Namely_API_Step_1.png

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.

Namely_API_-_Step_2.png

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.

Namely_API_-_Step_3.png

 

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.

Screen_Shot_2019-02-25_at_12.56.05_PM.png

Navigate to the Namely integration and input the copied down Personal Access Token and Subdomain in the provided fields.

Click Save when finished.

Namely_API_Step_4.png

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.

Screen_Shot_2019-02-27_at_2.26.03_PM.png

Select Export to Namely.

Screen_Shot_2019-02-27_at_2.27.08_PM.png

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

 

Screen_Shot_2019-02-27_at_2_31_53_PM.jpg