Permissions: Owner

Product tier: Available for Greenhouse Onboarding

Namely is a cloud-based Human Resource Information System (HRIS) that helps your organization manage and streamline compliance, record keeping, payroll, benefits, and more.

Namely's integration with Greenhouse Onboarding enables your organization to push employee profiles from Greenhouse Onboarding to Namely for easy account creation.

Note: Greenhouse Onboarding's integration with Namely offers a non-customizable, one-way sync of information.

Retrieve your 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 that precedes in the URL.

Namely integration image

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.


Click Personal Access Tokens and create a new access token. Use the provided field to input a name.

Note: We suggest giving the personal access token a recognizable name that illustrates the token is for the Greenhouse Onboarding integration.

Namely API settings page shows Personal Access Token tab and Create New Personal Access Token highlighted in marigold emphasis boxes

When finished, click Create.

Your newly created personal access token will be displayed. Copy the personal access token to a secure location.

Note: Your new personal access token will only be displayed once.

Namely API page shows an example generated Personal Access Token named abcdefghijklmnopqrstuvwxyz1234657980

Enable the Namely integration

Once you have your subdomain and personal access token, log in to Greenhouse Onboarding and click Settings on your navigation bar.

Click Integrations on the left.

Greenhouse Onboarding page shows the Integrations button highlighted in a marigold emphasis box

Scroll to the Human Resource Management panel and click Enable beside Namely.

Greenhouse Onboarding integrations page shows the Namely integration button Enable highlighted in marigold emphasis

Enter the personal access token and subdomain you copied in the previous step.

Click Save and close when finished.

Namely integration image

The Greenhouse Onboarding and Namely integration is now enabled for your organization!

Map fields between Greenhouse Onboarding and Namely

The following Greenhouse Onboarding fields will be mapped and exported to the corresponding field in Namely:

First Name*

Employment Type (Employment Status)

Emergency Contact Name

Last Name*

DOB / Date of Birth

Emergency Contact Phone

User Status*

Social Security Number


Start Date*




Profile Photo

Preferred Name

Phone Number

Marital Status

Reports to

Job Title

Personal Email


*Indicates this field is required to create a Namely employee account.

Note: Greenhouse Onboarding cannot add or remove mappings from this schema. Currently, the integration does not support department or location fields in Greenhouse Onboarding.

Update field options to match Namely

In order to successfully export data from Greenhouse Onboarding to Namely, both systems will need to have matching values for the following fields:

  • Job Title
  • Employment Status
  • Ethnicity
  • Marital Status

Log in to Namely to view the values you'll need to match for each of the above fields. Below is an example of Namely's available values for the Ethnicity field.


In Greenhouse Onboarding, navigate to Settings Fields. Click to select the field you need to update.

On the Edit Field page, update each value under Selection Options to match the field options from Namely.


Click Save when you're done editing field options.


Employment Status is a single-select field that maps to Namely. You need to update the external value for each field option in Greenhouse Onboarding to match the options available in Namely:

Greenhouse Onboarding value Namely value to match
Full-time Full Time
Part-time Part Time
Contract Contractor
Intern Intern

You'll change 'Full-time' to 'Full Time,' 'Part-time' to 'Part Time,' and 'Contract' to 'Contractor' when editing your Employment Status field values in Greenhouse Onboarding.

Map completed e-signature documents from Greenhouse Onboarding to Namely

Completed e-signature documents can be sent from Greenhouse Onboarding to Namely. To enable this, an Administrator must log into Namely and create a new profile field with a type of file for each e-signature document that will be mapped from Greenhouse Onboarding.

Note: Only e-signature documents can be mapped from Greenhouse Onboarding to Namely. Other employee documents cannot be mapped.

Have the Administrator log into Namely, then click Company from the top navigation bar and then click Profile Fields in the Employee Data section.


Create the new field, ensuring the name of the field is an exact match with the name of the e-signature template you wish to map to it from Greenhouse Onboarding.

For example, if the e-signature template in Greenhouse Onboarding is named Company Handbook, the field in Namely must be named Company Handbook as well.

Be sure to set the Type dropdown menu to File.

When finished, click Save.

Repeat these steps to map each e-signature document you wish to send from Greenhouse Onboarding to Namely.

Going forward, the appropriate e-signature document will be sent when a New hire is exported to Namely.

Use the Namely integration with Greenhouse Onboarding

Export an employee profile to Namely

Once the integration is enabled for your organization, you can export an employee profile to Namely directly from the employee profile.

Use the provided search bar to navigate to an employee profile and click Integrations.

A new hire profile for a person named Bethany Dauer from Chicago with Integrations button highlighted in marigold emphasis box

Click Export to Namely.

The Integrations tab on an employee profile for Bethany Dauer shows the Export to Namely button highlighted in marigold emphasis box

Note: Since each organization defines its onboarding processes differently, employee data can only be exported manually from Greenhouse Onboarding. Additionally, this export can only be performed once in Greenhouse Onboarding, so confirm the details of the export before proceeding.

The export will complete and will provide the following information on the employee's Integrations tab in Greenhouse Onboarding:

  • 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