Authorization

Connect your Greenhouse account to Okta Workflows using a Harvest API key.

About this task

When you add a Greenhouse card to a flow for the first time, Okta Workflows prompts you to configure the connection. This connection links to your Greenhouse account and saves your account information, so you can reuse the connection for future Greenhouse flows.

To create a Greenhouse API key:

Before you begin

  • Okta Workflows administrator authority

  • To create a Harvest API key, you must grant the Can manage ALL organization's API Credentials permission to an account. This permission setting is in the Developer permission section of your Greenhouse instance.

  1. Sign in to your Greenhouse instance with the user account that was granted permission.
  2. On the Home page, select Configure.
  3. Go to Dev Center > API Credentials.
  4. Select Create new API key.
  5. Select Harvest as the API type and select your Partners. Enter a memorable Description for the API key.
  6. Select Manage Permissions.
  7. Select Copy to send the new API key to your clipboard. Select I have stored the API key.
  8. Select the following Greenhouse Harvest API key permissions:

    Users

    Get: List Users

    Get: Retrieve User

    Post: Add User E-mail Address

    Patch: Update a user

    Candidates

    Get: List Candidates

    Get: Retrieve Candidate

    Patch: Edit Candidate

    Custom Fields

    Get: Get custom fields

  9. Select Save.

To create a connection in Okta Workflows:

  1. On the Connections tab, select New Connection.
  2. Select the Greenhouse icon in the New Connection dialog.
  3. Enter a Connection Nickname. Use a unique name, in case you need to create multiple Greenhouse accounts.
  4. Enter your API Key that you copied from the Greenhouse site.
  5. Select Create to save your configuration and create the connection.