1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Optimization

Pave integration

Pave allows companies to plan, communicate, and benchmark their compensation.

Greenhouse Recruiting’s integration with Pave allows recruiters and HR teams to present visual, interactive offer letters to candidates, empowering them to more confidently communicate the value of a candidate's proposed compensation and increase conversion.

In this article

Create a Harvest API key for the Pave integration

To configure the Greenhouse Recruiting / Pave integration, you’ll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Pave integration.

Credentials

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: Pave
  • Description: Pave Harvest API Key

Permissions

Verify that the following permissions are selected for the Pave integration:

  • Applications
    • Get: retrieve application
    • Get: list applications
  • Candidates
    • Get: retrieve candidate
    • Get: list candidates
  • Users
    • Get: retrieve user
    • Get: list users
    • Get: list user future job permissions
    • Get: list user job permissions
    • Get: list pending approvals
  • Offers
    • Get: list applications
    • Get: retrieve application's current offer
    • Get: retrieve offer
    • Get: list offers
  • Departments
    • Get: retrieve department
    • Get: list departments
  • Custom locations
    • Get: retrieve custom location for job board
  • Jobs
    • Get: retrieve job
    • Get: list jobs
  • Offices
    • Get: retrieve office
    • Get: list offices
  • User roles
    • Get: list user roles
  • Custom fields
    • Get: get custom fields
  • Custom field options
    • Get: custom field options
  • Approvals
    • Get: list approval flows for job
  • Demographic data
    • Get: retrieve demographic question
    • Get: list demographic question sets
    • Get: retrieve demographic question set
    • Get: list demographic questions for demographic question set
    • Get: list demographic answer options
    • Get: retrieve demographic answer option
    • Get: list demographic answers
    • Get: list demographic answer options for demographic question
    • Get: retrieve demographic answer
    • Get: list demographic answers for application

Create webhooks

To integrate Pave with Greenhouse Recruiting, you’ll need to create five webhooks. Follow the steps in this article to create your webhooks. 

Webhook 1: Offers created

  • Name: Pave Offers Created
  • When: Offer Created
  • Endpoint URL: The Endpoint URL provided by Pave
  • Secret Key: The Secret Key provided by Pave

Webhook 2: Offers updated

  • Name: Pave Offer Updated
  • When: Offer Updated
  • Endpoint URL: The Endpoint URL provided by Pave
  • Secret Key: The Secret Key provided by Pave

Webhook 3: Offers approved

  • Name: Pave Offer Approved
  • When: Offer Approved
  • Endpoint URL: The Endpoint URL provided by Pave
  • Secret Key: The Secret Key provided by Pave

Webhook 4: Offers deleted

  • Name: Pave Offer Deleted
  • When: Offer Deleted
  • Endpoint URL: The Endpoint URL provided by Pave
  • Secret Key: The Secret Key provided by Pave

Webhook 5: Candidate unhired

  • Name: Pave Candidate Unhired
  • When: Candidate Unhired
  • Endpoint URL: The Endpoint URL provided by Pave
  • Secret Key: The Secret Key provided by Pave

Use the Pave integration with Greenhouse Recruiting

Pave utilizes the Greenhouse API and Webhook implementation in order to create a Visual Offer Letter experience encompassing all relevant information to frame offer value to a candidate (compensation, benefits, company values, etc.)

Follow these steps to test the integration:

  • Create test offer
  • Create an offer utilizing all the fields you want for Pave

Note: Pave recommends using the following fields: salary, equity, any bonuses, variable pay, etc.

Let your Pave IPM know that you’ve completed the steps. When finished, Pave will do the following things:

  • Verify that Greenhouse is successfully forwarding events
  • Enable the integration
  • Schedule a training session
  • Use your test offer
  • Answer any questions for your team.
  • Contact you if any issues occur.

Additional resources

For troubleshooting assistance regarding this integration, reach out to support@pave.com or visit the Pave Support Site.