Rival Help CenterSearch
Help CenterSearchATS Integrations

Creating a Greenhouse API key

  1. Navigate to the Greenhouse "API Credentials" page (https://app.greenhouse.io/configure/dev_center/credentials) and click "Create New API Key".
  2. In the "Create new credential" box that appears enter "Entelo Integration" as the description and choose "Harvest" as the type. The Create new credential dialog with the description Entelo Integration and the type Harvest After hitting the "Create" button you will be brought to a page that allows you to specify the level of access this API key will provide.
  3. You should only enable the permissions that are absolutely necessary for the features you wish to use.
    • Candidates > GET: List Candidates will enable an additional Rival Search filter to allow you to include or exclude your Greenhouse candidates
    • Candidates > GET: Retrieve Candidate will allow Greenhouse-specific data to appear alongside Rival Search profiles and will display a link directly to that candidate’s Greenhouse page
    • Candidates > POST: Add Email will allow emails sent as part of an Track conversation to appear in the candidate’s Greenhouse activity feed. The Manage API Key Permissions page with the Candidates list expanded and some permissions checked

Adding your Greenhouse API key to Rival Search

  1. Navigate to your organization’s Integration page: https://www.entelo.com/organizations/<your-org-id>/settings

    Tip: If you don’t already have a Greenhouse integration you’ll need to create one.

  2. Once your integration is created you can navigate to the "Credentials" page (https://www.entelo.com/organizations/<your-org-id>/integrations/v2/greenhouse/settings) to add your Harvest (Greenhouse) API key: The Configure Greenhouse integration form with the Harvest Api Key field and a Save and continue button This page will provide you with the webhook username and password that you’ll need when you create your Greenhouse webhooks.

Creating the Greenhouse webhooks

"Webhooks" allow Greenhouse to send a secure message directly to Rival Search whenever changes occur with your Greenhouse candidates. To configure your Greenhouse webhooks, first navigate to the "Web Hooks" page in the Greenhouse developer center (https://app.greenhouse.io/web_hooks). You should be brought directly to the form for creating a new webhook.

The following settings will use the same values for every webhook you create:

Endpoint URL: https://greenhouse-webhooks.entelo.com/gh

Secret key: Organization name

Error recipient email: <leave empty>

Advanced Settings

Username: <webhook username from the Greenhouse integration page on Rival Search>

Password: <webhook password from the Greenhouse integration page on Rival Search>

Additional settings: <leave blank>

Maximum attempts: 25

Disabled?: No

Each of the following features will be enabled automatically when you create a webhook with the given value for the "When" field:

  • When I create new Greenhouse candidates I want to automatically attempt to link them to Rival Search profiles: Name this webhook: new_prospect_application When: Prospect created
  • When I delete a candidate from Greenhouse I no longer want that candidate to appear in my "show only Greenhouse candidate" searches: Name this webhook: delete_candidate When: Delete candidate
  • When I modify the name or email address of a candidate in Greenhouse I want to make another attempt to match the candidate with an Rival Search profile: Name this webhook: update_candidate When: Candidate or Prospect updated