Purpose Jobs integrates with Greenhouse to ensure you're able to export candidates directly to jobs within your ATS account. Using this integration, users will be able to source, access, engage, and track candidates exported from your Purpose Jobs account.

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Purpose Jobs integration, you will need the developer permission ‘Can manage ALL organization’s API Credentials’. If you do not have this permission, you will need to contact a Greenhouse user in your organization with Site Admin level permissions and the additional user-specific permission, ‘Can edit another user's advanced permissions’. This individual will be able to grant you the API credential management permission necessary to setup the integration.

Have the user with Site Admin level permissions edit your user account's permissions by navigating to the ‘Configure’ icon > ‘Users’ > ‘Your Name’.

From there, the user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.

They should select ‘Can manage ALL organization’s API Credentials’ so that a check is in the checkbox. When finished, click ‘Save’.

Repeat as necessary for any other user that should have access to set up the integration.

Establishing an API Key

Log into your Greenhouse account and navigate to the ‘Configure’ gear icon in the top right navigation bar. Select ‘Dev Center’ in the left-hand navigation and select ‘API Credential Management’ from the list of available options.

Select ‘Create New API Key’ and add a name in the ‘Description’ box. In the ‘Type’ dropdown select ‘Harvest’, and under ‘Client Application’ select ‘Purpose Jobs’ from the list:

To finalize your selections, simply press ‘Manage Permission’. Once the new API Key has been generated, select the ‘Copy’ button. This information will be used to configure the integration in your Purpose Jobs account settings.

Under "Manage Permissions", select all and click "Save."

Configuring the Integration

After logging into your Purpose Jobs account, navigate to ‘Account Settings’ in the bottom left-hand panel, and then select ‘Integrations’ from the list.

Paste the API Key from Greenhouse into the ‘API Key’ Field, then add your email address below. To finish the configuration, simply click the blue ‘Add Integration’ button.

Exporting Candidates

You can now export candidates from Purpose Jobs into Greenhouse. To set up the automatic transfer, you must first manually sync your jobs between Purpose and your ATS. To begin, click 'Jobs' on the left hand side of your screen. Choose the job(s) you want to connect with Greenhouse by clicking 'Edit' next to each role. On the next page, you'll see a 'Connect Greenhouse Job' option to link that job with a specific position in your ATS. Once you choose the job, click 'Save' at the bottom of the page. Applicants to any synced jobs will now export to your Greenhouse ATS automatically.

Adding Candidates to Greenhouse

In addition, you will still be able to manually export candidate profiles from the candidate cards. As shown in the screenshot below, click the ‘Share’ button. Choose ‘Send to Greenhouse’:

Select the job you wish to send the candidate to from the list and click 'Send to Greenhouse'.

Once you’ve successfully exported the candidate, you’ll see a confirmation of success in the upper right-hand corner of the page in Purpose Jobs.

You can now interact with the candidate profile as you typically would within Greenhouse, and move them through your interview plan accordingly!

Email us at support@purpose.jobs if you have any questions about the Purpose Jobs/Greenhouse integration.

Did this answer your question?