Caro creates a single source of truth for headcount to align finance teams, talent teams, people teams, and hiring leaders.

Caro’s integration with Greenhouse Recruiting provides visibility into hiring progress for all headcount. This helps finance teams keep the financial forecast accurate, and gives hiring leaders visibility into their pacing against their hiring goals.

Create a Harvest API key

To configure the Caro 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 Caro integration.

Credentials

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

  • API Type: Harvest
  • Partner: Caro or Unlisted Vendor
  • Description: Caro Harvest API Key

Paste the API key into this secure sharing link. Share the generated link with your Caro onboarding team.

Permissions

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

  • Applications
    • Get: List Applications
    • Get: Retrieve Application
  • Candidates
    • Get: List candidates
    • Get: Retrieve candidates
  • Custom Fields
    • Get: Get custom fields
  • Departments
    • Get: List Departments
    • Get: Retrieve Department
  • Job Openings
    • Get: List Openings For a Job
  • Jobs
    • Get: Get hiring team
    • Get: List Jobs
    • Get: Retrieve Job
  • Job Stages
    • Get: Retrieve Job Stage
    • Get: List Job Stages for Job
    • Get: List Job Stages
  • Offers
    • Get: List Offers
    • Get: Retrieve Offer
    • Get: Retrieve Application's Current Offer
    • Get: List Application's Offers
  • Offices
    • Get: Retrieve Office
    • Get: List Offices
  • Scheduled Interviews
    • Get: List Interviews
    • Get: List Interviews for Application
  • User
    • Get: List Users
    • Get: Retrieve User

Create a webhook

To integrate Caro with Greenhouse Recruiting, you’ll also need to create several webhooks. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhook:

  • Name: See table below
  • When: See table below
  • Endpoint URL: The Endpoint URL provided by your Caro onboarding team
  • Secret Key: The Secret Key provided by your Caro onboarding team
Name this webhook When
caro_candidate_hired Candidate has been hired
caro_candidate_unhired Candidate has been unhired
caro_stage_change Candidate has changed stage
caro_job_approved Job approved
caro_job_created Job created
caro_job_deleted Job deleted
caro_job_updated Job updated
caro_offer_approved Offer approved
caro_offer_created Offer created
caro_offer_deleted Offer deleted
caro_offer_updated Offer updated

Use the Caro integration with Greenhouse Recruiting

Caro’s integration with Greenhouse Recruiting helps talent teams, finance teams, and hiring managers collaborate around a single source of truth for headcount.

View hiring progress within the overall headcount plan.

View offer details and variance to budget by clicking into a headcount row.

Additional resources

For additional information or troubleshooting not covered here, reach out to support@carohq.com.