How can we help you?

Yext

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 Configure.png  > Users > Your Name

Configure_-_Users.png

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.

ALL_API_Credentials.png

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 Configure.png 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.

Dev_Center_-_API_Credential_Management.png

From the API Credential Management page, click Create New API Key to generate the API key for Yext.

Create_New_API_Key.png

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.

mceclip0.png

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
  • Jobs: 
    • GET: Retrieve Job
    • GET: List Jobs

mceclip1.png

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

image-7.png

Enter your Yext credentials to authorize the app to access your account. 

image-8.png

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. 

image-9.png

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! 

 

Get Help 

Please contact app-developer-support@yext.com for troubleshooting assistance regarding the integration.