Greenhouse Recruiting’s integration with join.com allows your organization to synchronize your Greenhouse jobs to join.com and return candidates generated by join.com to Greenhouse.

Retrieve a user ID

join.com will need a Greenhouse Recruiting User ID to associate with the data.

Note: If your organization has a general user (like recruiting@) instead of a specific person (like jane@), we suggest you use the general user so that if the specific user ever leaves the organization, the integration remains intact. 

Site Admins can find a user's ID by exporting a list of users from Greenhouse Recruiting to Excel. (Configure Configure-icon.png > Users > Export to Excel)

Screenshot-of-export-to-excel-button.png

Open the Excel file and navigate to the User ID column. Select a user from the column that will be associated with any data pushed from join.com to Greenhouse Recruiting and copy down their User ID.

Note: If you would prefer to create a new user specifically to be associated with data pushed from join.com to Greenhouse Recruiting, follow the steps linked here.

Screen_Shot_2019-07-19_at_5.01.56_PM.png

Create a Harvest API key for the join.com integration

To configure the Greenhouse Recruiting / join.com integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the join.com integration.

Credentials

In the Create New Credential box, make the following selections:

  • API type: Harvest
  • Partner: join.com (optional)
  • Description: join.com Harvest API key

Permissions

Verify that the following permissions are selected for the join.com integration:

  • Applications
    • Select all
  • Candidates
    • Select all
  • Custom Fields
    • Select all
  • Sources
    • Select all

(Optional) Create a custom candidate field for the assignment of a secondary source

If you would like to have the original source of the candidate displayed in Greenhouse, your organization can create a custom candidate field to capture the platform from which the candidate originated (e.g. LinkedIn, Indeed).

Note: In order to create a custom candidate field, a user will need either Site Admin permissions or Job Admin permissions who can also Manage company metadata.

To add a secondary source, navigate to the Custom Options page and create custom candidate field with the following options:

Field name: Join original source

Field Type: Short textbox

After saving the custom candidate field, Greenhouse Recruiting will generate an immutable field key for the field. Copy the immutable field key down in a secure location.

Screenshot of join.com immutable field key

Enable the Greenhouse/join.com integration

You can set up the integration on join.com by going to Settings > Integrations. It can take one to two working days for all jobs to be indexed on join.com and the first applications to be sent to Greenhouse.

To avoid the duplication of applications in Greenhouse, only the new applications are sent through. If you still have applications on join.com that you would like to send to Greenhouse, please use the export functionality from join.com.

To avoid the duplication of applications in Greenhouse, only the new applications are sent through. If you still have applications on join.com that you would like to send to Greenhouse, please use the export functionality from join.com.

Once the integration is enabled on join.com:

  • Your jobs will be synchronized once a day, meaning that new jobs will be created and old jobs will be archived automatically. You are free to create additional jobs or edit the existing jobs on join.com.
  • New candidates that apply on join.com will be sent to Greenhouse at the time of application and updated if the candidate uploads more information.
  • Candidates received previously will not be sent to Greenhouse to avoid duplication. If you want older candidates to be available on Greenhouse, you can do so by exporting candidates from https://join.com/applications and uploading them on Greenhouse (contact join.com for more information).
  • If a candidate applies to multiple positions, the candidates will not be duplicated.

Additional resources

Please send an email to contact@join.com or reach out to your join.com account manager for troubleshooting assistance regarding the integration.