1. Help Center
  2. Setting Up Connectors


Configure your Crosschq Connector with Greenhouse

Read the sections below to learn more about the steps necessary to connect Crosschq with GreenHouse:

Connecting to Greenhouse

Submitting the token to Greenhouse

  1. Login to your Crosschq administrator account, then click Organization Settings > Connectors item on the menu. Locate the GreenHouse listing in the main panel, then click the Manage button.
  2. To enable the Greenhouse connector, click the toggle switch such that it turns green in color. Next, select and copy the Token.Sin título-Jun-28-2022-06-42-54-58-PM
  3. Reach out to Greenhouse support via chat and they will send a Safely link where you can securely share the token. After sharing the token with Greenhouse, their support team will then connect the two platforms to one another. If, at any point, you need to adjust connector settings, simply return to Organization Settings > Connectors > Greenhouse and click on the Manage button.

Enabling Recruiter Ownership

To enable individual recruiters to own their candidates, you'll need to create another Harvest API Key for Crosschq.

Follow these steps to generate a Harvest API key and connect Greenhouse:

  1. From the Greenhouse Dev Center, click on the API Credential Management link.

  2. Click the Create New API Key button to generate the API key for Crosschq.

    In the popup window, enter a Description and choose Harvest from the Type drop-down, and add "crosschq" to the source identifier. Then, click the  Create button and copy the API key.
    From there you will need to select the appropriate permissions that Crosschq will have access to, please select the following permissions in your Greenhouse Harvest API KEY:

    -GET: Retrieve Application
    -PATCH: Update Application
    -POST: Add Attachment to Application

    - GET Retrieve Candidate
    - GET List Candidate

    - GET Retrieve User
    - GET List User

    Job Stages
    - GET: Retrieve Job Stage
    - GET: List Job Stages
    - GET: List Job Stages for Job

    - GET: Retrieve Job
    - GET: Hiring team

    Prospect Pool
    - GET: List Prospect Pools

    Optional Custom Field Options:
    - GET: Custom fields
    - POST: Create custom field
    - PATCH: Update custom field

    Additional fields recommend for customers using Crosschq Recruit and who want to ingest enriched prospects to Greenhouse:

    - POST: Add Prospect 
    - POST: Add Employment 

    - GET: Degrees
    - GET: Schools

    If enabling New Hire Analytics for Crosschq, select additional permissions:

    -  GET: Retrieve EEOC Data for Application
    -  GET: List EEOC


    -  GET: List Departments

  3. Login to your Crosschq administrator account, and go to Organization Settings > Connectors. Locate the Greenhouse listing in the main panel, then click the Manage button.
  4. Paste the copied Harvest API key into the Harvest APIKey field.
    Then you should see the assigned recruiter from Greenhouse listed under the "Requestor" column in Crosschq. Keep in mind that any recruiter needs a Crosschq login to appear as a candidate owner.
    Sin título-Jun-28-2022-06-44-15-88-PM
Crosschq pulls the Recruiter and Hiring Manager from the details section within a candidate's profile. The recruiting and hiring manager listed within the candidate's profile will then be assigned as the Requestor of the Crosschq.

Enabling the Hiring Status Webhook

The hiring status webhook automatically updates the hiring status of a candidate in Greenhouse when they are hired in Crosschq.

NOTE: If a candidate is not hired, the owner of the candidate will receive an email two weeks after Crosschq is complete that prompts the owner to indicate if the candidate was hired. When the owner responds to this email message, the status will update in both Crosschq and Greenhouse.

Follow the steps below to enable this webhook:

  1. In Crosschq, go to Organization Settings > Connectors > Greenhouse, then copy the Greenhouse Webhook Hired URL, by clicking the copy button on the far right.
    Sin título-Jun-28-2022-06-44-15-88-PM
  2. Next, log in to Greenhouse, click on Settings, then click on the Dev Center, click Web Hooks, and select Web Hooks again. 

    1. First, give a Name to the webhook.
    2. In the When drop-down, select "Candidate has been hired".
    3. In the Endpoint URL field, paste the Greenhouse Webhook Hired URL that you copied from Crosschq.
    4. In the Secret Key box, paste the Greenhouse token from Crosschq.
    5. Then enter an Error recipient email, which is typically the email address of a super administrator.
    6. Check the No option to ensure that WebHook is not disabled.
  3. Finally, click the Create Webhook button. From there, the hiring status should automatically update for all future candidates.

Set Templates

Within Crosschq, go to Organization Settings > Templates. Select Create New Template. 

Enter the required information such as template name, add in an ATS Tag for that template if required, and create a description of the template.  

Within the Request Settings, add in the position, select the appropriate survey, and configure the number/type of references you want to be associated with this request. Please note, the relationship type can either be specified or you can select any relationship type and let the candidate determine the type of reference. Additionally, you can add customized notes to each specific reference request, i.e. "Please provide a manager reference from X company."

From there, add in optional hiring manager information. Finally, you can create custom emails or text messages associated with each template by filling out the custom notifications section. When you are done, select Create Template.


At any point, if you need to edit or delete a template select the three dots next to the template and you can manage from there. 


Adding Crosschq as a Stage in an interview plan

After setting the connector defaults, create a new job within Greenhouse and add Crosschq as a stage within your interview plan.

You can also bulk-add Crosschq to all your existing jobs by following these steps:

1. Access jobs, check the box to bulk select all jobs, and click Stages/Interviews.

2. Next, select Add a stage within the "Re-Order Stages" section, search for Crosschq and click add. Then save the changes.

Sending a Crosschq Request

After adding Crosschq as a stage, all candidates that apply will be sent through all of the stages that you specified—including your new Crosschq Connection.

To send a candidate through the Crosschq process:

  1. Click into the Crosschq stage, then provide the candidate email address and select which type of pre-created default survey you want the references for this candidate to complete. Select whom you would like to "grade" the request/have access to notifications, usually, this is the recruiter/candidate owner.
  2. Click the Send Test button to send the Crosschq to the candidate.
  3. The candidate will receive an email message that includes a link to begin the Crosschq process.

  4. When the candidate completes the self-reference and all of the references respond to the surveys, the report will be available within the Greenhouse platform. Additionally, the recruiter and hiring manager will also get an email informing them that the Crosschq report is completed. (If the hiring manager doesn't have a Crosschq account a link to create a Viewer account will automatically be sent to the hiring manager.) The figure below depicts an example in which a candidate has received his overall Crosschq score and the process is complete.

  5. To view the report directly, click the report icon next to the Crosschq stage.
    (Note: there are two Crosschq stages in the above image as this is a testing account, for normal accounts, there will only be one Crosschq stage.)

    Screen Shot 2020-03-18 at 6.42.03 AM
  6. To view the completed Crosschq report, click View Report which will take the user to the completed report in Crosschq. (Note: Only those with Crosschq accounts will be able to access the Crosschq report.)

    Screen Shot 2020-03-18 at 6.42.34 AM
  7. Greenhouse users that have enterprise accounts will be able to view a more detailed version of the Crosschq report and status updates related to the report. To access this, users will select the private tab in the candidate's profile.
    Screen Shot 2021-09-16 at 6.51.43 AM

Prospect Ingestion

To enable the Prospect Ingestion feature and export all Crosschq prospects to Greenhouse, follow these steps:

  1. Go to the CRM section in Greenhouse to configure a new prospect pool.
    (Note: if you do not have the CRM function, you can export prospects and manually upload them to Greenhouse.)
  2. Then go to the Greenhouse Dev Center, and click on the API Credential Management link.

  3. Click the Create New API Key button to generate the API key for Crosschq.

    Sin título-png-Apr-28-2022-04-36-20-82-PM

  4. In the popup window, enter a Description and choose Candidate Ingestion from the Type drop-down. Also, choose Crosschq from the ClientApplication drop-down. Then, click the  Create button and copy the API key.

  5. Navigate back to the Greenhouse section of Crosschq, scroll down to the Export Prospects from Crosschq to Greenhouse section, and ensure that it is enabled.

  6. Click Edit Parameters, and paste the copied API in the Token space.
  7. Enter in a Greenhouse admin email to be associated with the connection.
  8. Click into the prospect pool and select the correct Prospect Pool for Crosschq prospects to be exported to.
    (Note: The ID Number is actually the name of a prospect pool. The admin for Greenhouse will likely want to create a specific prospect pool for Crosschq candidates, and then select that pool from the drop-down menu.)

After completing the Greenhouse connection, all of your prospects will automatically or manually export into Greenhouse. To enable automatic exportation click Yes to automatically export.