Guided Compass is a black-owned career development platform that allows education and workforce organizations to refer diverse candidates directly to employers, at scale. Our platform serves people over a wide range: from high school to mid-level roles . Over 90% of career-seekers on our platform are minorities and we’ve been used by 500+ education and workforce organizations over the past year.

Adding Guided Compass to your Greenhouse instance allows us to automatically distribute relevant job opportunities, and post referred, screened candidates from our training partners.

In this article:

Make sure you have the right permissions

In order to enable the Greenhouse/Guided Compass integration, you will need the following developer permissions:

  • Can manage ALL organization’s API Credentials. 
  • Can manage and configure web hooks

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    > 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 and Can manage and configure web hooks so that checks are in the checkbox. When finished, click Save .


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

Integrate Guided Compass

Navigate to and follow the below steps. If you have the right permissions, this should take less than 5 minutes.

  1. Sign Up/Sign In
  2. Confirm employer information

Next, click Authorize to allow Guided Compass to use your Greenhouse account. 


Web Hooks setup

From your Greenhouse Recruiting dashboard, click on the Configure icon image4.png in the upper right-hand corner. Then, navigate to the Dev Center  on the left-hand panel.


From the Dev Center, click Web Hooks . Click Web Hooks from the subsequent page.


You will be directed to a new page where you Create a New Web Hook . From this page provide the following details:

  • Name : we suggest “GC - [Event Name]”
  • When : Start with “Job Post Created”. We’ll need to create separate webhooks for each event.
  • Endpoint URL : To be received from the Guided Compass team after authorization
  • Secret Key : To be received from the Guided Compass team after authorization

When finished, click Create Web hook .


After creating the first webhook for “Job Post Created”, create four others with identical fields:

  • Job Post Updated
  • Job Post Deleted
  • Candidate or Prospect rejected
  • Candidate has been hired

That's it! Guided Compass is integrated!

Maximizing your Guided Compass experience [optional]

Receiving candidates

Training partners typically only refer 3-5 candidates at one time. Partners can drag-and-drop the candidates they would like to refer, so candidates are referred according to their rankings with notes.

When candidates are posted from us, we will include the following in the notes:

  • The ranking from the partner organization (For example, #2);
  • The name of the referring organization (For example, Los Angeles City College);
  • The match score (For example, 89%) – calculated using our algorithms against your ideal candidate; this includes scores input by partners (e.g., internal coursework, interviews).

In order to allow Guided Compass to relay details on candidates, you should consider adding three custom candidate fields in Greenhouse Recruiting:

  • referring_org
  • ranking
  • match_score

Click on the Configure icon image4.png in the top right-hand corner of your Greenhouse Recruiting dashboard.  Then, navigate to Custom Options on the left-hand panel.


Click Candidates from the Company Custom Fields section. 


On the Custom Fields: Candidates page, click Add Field.


Create the following fields:

  • referring_org
  • ranking
  • match_score

Receiving prospects

If you have specified a “benchmark” or ideal candidate, posted an event, or posted a project, we can push leads to build your talent pipeline.

The following will allow us to provide the best service to you:

  • Feedback on any and all candidates referred from the Guided Compass platform.
  • Consider posting events and projects to give candidates chances for extra points here:
  • Consider designing benchmarks for your departments, including recommended courses, for better trained/screened candidates.

Contact Guided Compass

Need help? Contact for troubleshooting assistance!