VONQ offers recruitment marketing technology to turn passive and active candidates into qualified applicants. To steer recruitment teams’ success, VONQ offers performance data analytics and job market insights. Greenhouse Recruiting’s integration with VONQ allows users to push active jobs to VONQ’s platform to easily create advertisement campaigns and distribute their jobs to over 2000 channels. In this article, we will cover how to:


Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/VONQ integration, you will need the developer permission Can manage Job Board related API Credentials.

Contact a Greenhouse 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.


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 Job Board related 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.

Note: We recommend that the user configuring the integration also have Site Admin level permissions in Greenhouse Recruiting in order to retrieve the job board token.


Create a Job Board API Key for the Greenhouse/VONQ Integration 

To create a Job Board API key for the integration, click on the Configure icon configure.png in the upper right-hand corner. Navigate to 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 VONQ.


From the Create new credential dialog box, give your API key a name and select Job board from the Type dropdown menu. When finished, click Create.


Your Job Board API key for the Greenhouse/VONQ integration is created and configured. Copy the Job Board API key and forward to your VONQ representative using a secure method.



Retrieve Job Board Token 

VONQ requires a job board token from your organization in order to know which jobs you want to send to them. To retrieve a job board token, click Configure configure.png in the upper right-hand corner and select Job Board from the left hand panel.


From the Configure Job Boards page, click the ellipsis ellipsis.png inline with a job board and select Edit from the dropdown menu.  


Navigate to the URL section and copy the value in the provided field. This is the job board token for this job board.


Copy the job board token and forward it to your VONQ representative. 


How to Use the VONQ Integration with Greenhouse Recruiting

Every job in Greenhouse Recruiting with an OPEN status will be sent to VONQ.  

From your VONQ dashboard, click on jobs in the VONQ menu and you will find your open jobs. 

Click on create a campaign to start a campaign. 

Get a media recommendation.

From here, you can order a campaign. Most details are already prefilled by having the integration in place. Such as the job description and job page URL / apply URL.  

Once, all information is filled. Click the order button.

VONQ will put the ad online and inform you via email and via our interface about the progress of the campaign.

Review the performance of the campaign in your dashboard.