Mosaictrack predicts who the hiring team will want to interview. By creating an AI model based on job descriptions, Mosaictrack is able to create a short list of candidates for recruiters to review. Recruiters have the option of screening the people who applied to a job or to discover past candidates that may be a match to a new job.
Greenhouse Recruiting's integration with Mosaictrack allows new candidate information, resumes, job requisitions, and application logging by job to be imported into Mosaictrack.
In this article:
Configure user setup permissions in Greenhouse Recruiting
In order to enable the Greenhouse Recruiting / Mosaictrack 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 permission and the user-specific permission Can edit another user's advanced permissions to apply the developer permission to your account.
Have the user with Site Admin level permissions edit your user account's permissions by navigating to Configure icon > Users > Your Name.
The user with Site Admin level permissions should navigate to the User-Specific 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 a Harvest API Key for the Greenhouse Recruiting / Mosaictrack integration
To create a Harvest API key for the integration, click the Configure icon 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 Mosaictrack.
In the Create New Credential dialog box, make the following selections:
- API Type: Harvest
- Partner: Mosaictrack
- Description: Mosaictrack Harvest API Key
When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Mosaictrack.
In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Mosaictrack in the next step. Click I have stored the API Key once you have copied and saved the key.
On the Manage API Key Permissions page, include the following permissions:
- GET: Retrieve Candidate
- GET: List Candidates
- POST: Add Candidate
- POST: Add Attachment
- POST: Add Application
- POST: Add prospect
- GET: Retrieve Application
- GET: List Applications
- GET: List Job Posts
- GET: Retrieve Job Post for Job
- GET: List Job Posts for Job
If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished.
Your Harvest API key for the Greenhouse Recruiting / Mosaictrack integration is created and configured. Provide your Harvest API key to Mosaictrack to complete setup.
Create a new user for the Greenhouse Recruiting / Mosaictrack integration
To enable the Mosaictrack integration, you'll need to create a new user in Greenhouse Recruiting who will have permissions to upload new candidates and resume attachments.
While you can use any Site Admin user in Greenhouse Recruiting, we recommend creating a new user that will only be used for interacting with the integration. For example, a user called Mosaictrack API.
To add a new user, click the Configure icon from any Greenhouse Recruiting page, then click Users on the left.
Select + New Users.
Fill out the required fields. Make sure you choose Site Admin for the permission. Click Save when finished.
When complete, click Configure icon > Users, then select the new user you just created by clicking on the name.
On the user account page, note the user ID present in the browser URL. In the example below, the user ID would be 10101010101:
Provide the user ID to Mosaictrack to complete the setup.
Retrieve Mosaictrack's endpoint URL and secret key
In order to complete the last setup step involving web hook creation, reach out to Mosaictrack to retrieve the following information:
- Mosaictrack's endpoint URL
- Mosaictrack's secret key
Setup a web hook for the Greenhouse Recruiting / Mosaictrack integration
With Mosaictrack's endpoint URL and secret key copied, and your Greenhouse Recruiting user permissions enabled, you are ready to setup a web hook for the integration.
To setup a new web hook in Greenhouse Recruiting, click Configure icon and select Dev Center on the left.
From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page.
On the Create a New Web Hook page, enter the following details:
- Name: Mosaictrack Integration
- When: Candidate has submitted application
- Endpoint URL: Enter the endpoint URL received from Mosaictrack
- Secret Key : Enter the secret key received from Mosaictrack
When finished, click Create Web hook.
That's it! Your Greenhouse Recruiting account and Mosaictrack account can now talk to each other.
Optional: Setup the Greenhouse Recruiting URL for when viewing a candidate or requisition on Mosaictrack
To setup the Greenhouse Recruiting URL for when viewing a candidate or requisition, login to Mosaictrack and choose My Company in the navigation menu.
In the Company section, choose My Company.
On the subsequent page, enter the first part of the URL in the appropriate field, and choose Save.
Use the Mosaictrack integration with Greenhouse Recruiting
Once you have Mosaictrack and Greenhouse Recruiting integrated, you may start with Mosaictrack to complete a candidate search, then move to Greenhouse Recruiting to manage your recruiting efforts.
From the navigation menu, select Jobs, then click on a job.
Click Discover Candidates on the left.
Next, click Discovery from the top navigation.
Use the Job Title field on the left. Simply start typing the name of the job you are searching for, then choose a job from the list.
You have the option to only search for people who have applied to the job. Check Applied Only toggle on the left to toggle on this screening.
You may also uncheck the Applied Only to consider all candidates that have applied to any job. This would include all candidates in Greenhouse Recruiting. This method of sourcing is often called discovery, rediscovery, or simply sourcing.
Next, click the Search button to view results.
After clicking Search, you'll see a list of people ranked by scores graded on a curve. Mosaictrack compares the text of the job to the text of candidate resumes based on artificial intelligence modeling to predict who will be asked to interview. These models are updated in the background continually. A score of 100% means the resume is the best you currently have for the job, though necessarily the best person possible. People are graded using Mosaictrack's artificial intelligence modeling, machine learning, and other AI techniques.
Next, you may review the resume and the candidate. Click Match to compare matching sentences from the job description and the resume to give insights into the person's qualifications.
You may also view the candidate or requisition in your Greenhouse Recruiting by clicking on View in ATS (be sure to complete the optional setup first!). On Greenhouse Recruiting, you may manage how you engage with the candidate.
Can't find a job? Mosaictrack automatically updates and displays requisitions in Mosaictrack that have active job posts.
If you want to work with a job in Mosaictrack that doesn't have a public/active job post, first change the status of the job to Internal just below the Note section when viewing a job in edit mode. Then remove the job from the job board.
For additional information not covered here, reach out to Mosaictrack at firstname.lastname@example.org
or by phone at 206-486-2167.