How do I generate API keys for Partners that work with Greenhouse?

Greenhouse allows various partners to reach out to it's Partner API to streamline the recruiting process. (Partner Client applications include Rolepoint, Entelo, Blue Glue, RecruitiFi, Hirable, Resu.me, Simppler, Piazza, Hired.com, and Connectifier)

Important note: Only users who have the advanced "Can manage ALL organization's API credentials" permission can generate Partner API keys.

Take the following steps to generate the API Key:

  • Click the Configure tab
  • Click Dev Center
  • Click API Credential Management

 

On the API Credential Management page, click the Create New API Key button.

 

From the Type drop-down menu, select Partner.

From the Client Application drop-down menu, select the partner application for which you are generating the API Key. 

 Entering a description is optional. When finished, click Create.

This will generate your API key which you can then share with your Partner Applications. Your Account Manager for each respective Application should be able to help you with the actual implementation of the integration in their app. 

Please Note: While the Partner API key is meant to be shared, providing your Harvest API key with partners is like making them a Site Admin in your organization. With our new Harvest API key permissions however, you can now control which Harvest API endpoints a partner can access with their key. If a partner requests a Harvest API key, you'll want to check with your partner to review and confirm what endpoints they need access to for their integration. For more information, check our Harvest API key permissions FAQ: https://greenhouse.zendesk.com/hc/en-us/articles/115000521723

Have more questions? Submit a request

Comments

  • Avatar
    Christian Bongiorno

    I assume this key is a header value I am supposed to submit. But what is the header?

  • Avatar
    Murphy

    Hi Christian,

    You can read about our API documentation on this page: https://app.greenhouse.io/configure/dev_center/harvest

    For the partner API keys, you just need to pass it over to your account manager at the partner company so they can get things set up. Please let us know if you have any other questions!

    Thanks,
    Murphy

  • Avatar
    Dan Chen

    I found that I can't Entelo partner key permission, why?

  • Avatar
    Dan Chen

    I found that I can't change Entelo partner key permissions, why?

  • Avatar
    Olivia Hirsch

    Hi Dan,

    Thanks for writing in and apologies for the delay!

    In order to manage API Partner Keys in Greenhouse, you would need the developer permission of "Can manage ALL organization's API Credentials".

    I'd recommend talking to someone on your team to make this change to your account if needed. Users will not be able to adjust their own account permissions but someone with the permission of "Can edit another user's advanced permissions" could enable this.

    Hope this helps! Feel free to reach out to support@greenhouse.io with any additional questions!

    Thank you,
    Olivia

Powered by Zendesk