The ultimate source for official answers about a business online should be the business itself. However, when consumers ask questions on company websites, too often they are left in the dark with wrong answers. Yext, the Search Experience Cloud, solves this problem by organizing a business's facts so it can provide official answers to consumer questions — wherever people search. Starting with the company website, then extending across search engines and voice assistants, businesses around the world, trust Yext to radically improve the search experience on their websites and across the entire search ecosystem.
Greenhouse Recruiting’s integration with Yext allows mutual customers to automatically sync job data such as title, description, location, and application URL to Yext on an hourly cadence. Any time you add, update, or remove a job posting in Greenhouse Recruiting, these same changes will occur in Yext. Now you can extend the reach of your Greenhouse Recruiting job data even further to power Yext products such as Answers and Pages!
In this article, we will cover how to:
Configure User Setup Permissions in Greenhouse Recruiting
In order to enable the Greenhouse Recruiting / Yext integration, you will need the developer permission Can manage ALL organization’s API Credentials.
Contact a Greenhouse Recruiting user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon > Users > Your Name.
The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.
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.
Create Harvest API Key for the Greenhouse Recruiting / Yext Integration
To create a Harvest API key for the integration, click the Configure icon in the upper right-hand corner. Navigate to the Dev Center on the left-hand panel.
From the Dev Center page, click API Credential Management.
From the API Credential Management page, click Create New API Key to generate the API key for Yext.
From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.
On the Manage API Key Permissions page, grant your API key the following permissions:
- Job Posts:
- GET: List Job Posts
- GET: Retrieve Job Post for Job
- GET: List Job Posts for Job
- GET: Retrieve Job
- GET: List Jobs
When finished, click Update at the bottom of the page.
Your Harvest API key for the Greenhouse Recruiting / Yext integration is created and configured. Copy the API key to enter in Yext in the next step.
Install the Greenhouse Recruiting / Yext Integration
To install this app, you will need a Greenhouse Recruiting account and a Yext account with a subscription to the Base Package or higher (with available Job entities).
To install, navigate to the App Directory in your Yext account and click the Greenhouse app. Click Install.
Enter your Yext credentials to authorize the app to access your account.
If you have not created a Harvest API key for the integration in Greenhouse Recruiting already, follow the provided steps to create a Harvest API key. If you created a Harvest API key in the previous step, use that key here. Once you have created a Harvest API key, copy the API key and enter it in the provided space.
Follow the instructions in the installation flow to retrieve your job board token from Greenhouse Recruiting and enter it in the space provided.
Indicate whether you would like jobs deleted in Greenhouse Recruiting to also be deleted in your Yext account.
Click Confirm and Sync.
Your jobs are now syncing from Greenhouse Recruiting to Yext!
Please contact firstname.lastname@example.org for troubleshooting assistance regarding the integration.