join.com's integration with Greenhouse Recruiting allows your organization to sync your jobs to join.com and import candidates to Greenhouse Recruiting.
Set up the join.com integration
Retrieve a user ID
join.com requires a Greenhouse Recruiting user ID to associate with the integration requests. It's recommended to create a new integration system user (ISU) in Greenhouse Recruiting specifically for the integration. However, you can also find an existing user ID to authenticate the integration requests.
Copy the user ID for use in a later step.
Create a Harvest API key
Next, create a Harvest API key. Follow the steps in this article to create the key. In the Create New Credential box, make the following selections:
- API type: Harvest
- Partner: join.com
- Description: join.com Harvest API key
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 a secondary source
If you'd like to have the original source of the candidate displayed in Greenhouse Recruiting, your organization can create a custom candidate field to capture the platform from which the candidate originated — for instance Indeed or LinkedIn.
Note: To create a custom candidate field, you'll need to be a Site Admin or Job Admin who can manage company metadata.
To use secondary sources, create a custom candidate field and use the following settings:
- Field name: Join original source
- Field type: Short textbox
After you create the custom candidate field, Greenhouse Recruiting will generate an immutable field key:
Copy the immutable field key for use in a later step.
Enable the integration
Enable the integration on join.com by navigating to Settings > Integrations. Enter the information copied in the previous steps.
Use the integration
After setup and enablement of the integration, it can take 1 — 2 working days for all jobs to be indexed on join.com and for the first applications to be sent to Greenhouse Recruiting.
To avoid duplicate applications in Greenhouse Recruiting, only new applications are imported. If you still have applications on join.com that you would like to send to Greenhouse Recruiting, use the export functionality on join.com.
Once the integration is enabled:
- Your jobs will be synchronized once a day, meaning that new jobs will be created and old jobs will be archived automatically. You're 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 Recruiting at the time of application and will be updated if the candidate uploads more information.
- Candidates received previously will not be sent to Greenhouse Recruiting to avoid duplication. If you want older candidates to be available on Greenhouse Recruiting, you can export them on join.com.
- If a candidate applies to multiple positions, the candidates won't be duplicated in Greenhouse Recruiting.
Additional resources
Email contact@join.com or reach out to your join.com account manager for help troubleshooting the integration.