Workato docs Return to Workato
Edit this page
GitHub (opens new window)
  • Introduction
  • Getting started
  • Product Updates (opens new window)
  • Building recipes

  • Running recipes

  • Troubleshooting

  • Data types and formulas

  • Tools
  • Files and attachments

  • Batch processing

  • Teams and collaboration
  • People Task by Workato
  • Recipe lifecycle management
  • On-prem connectivity
  • Key features
  • Workbot for Slack
  • Workbot for MS Teams
  • Workbot for Workplace
  • API Platform
  • Connectors

  • Universal connectors
  • Community connectors
  • Connector SDK
  • Custom OAuth profiles
  • Workato API
  • Security
  • Training & Certification
  • Contact us

# Greenhouse


Greenhouse (opens new window) is an applicant tracking system and recruiting software that is designed to help make companies great at hiring and hire for what's next.

Workato's Greenhouse connector enables you to build even more automation around applicant and candidate workflow and connect with other human resource management systems.

# API version

The Greenhouse connector uses Greenhouse Harvest API v1 (opens new window).

# How to connect to Greenhouse on Workato

Create a Workato connection to your Greenhouse instance using API token credentials.

# API token credentials

Use API token credentials to allow Workato access to your Greenhouse instance.

Authentication using API token credentials Authentication using API token credentials

Connection field Description
Connection name Provide a unique name that identifies which Greenhouse instance it is connected to.
API key The API token credential. Learn how to create an API key below.
User email The user email this API token is generated from.
Environment Choose between sandbox and production Greenhouse environments for this connection.

# How to create an API token for Workato

It is recommended to use an Integration System User (ISU) for integration with Workato. This ensures that permissions are consistent and all operations can be logged on a single account.

Step Description
1. Navigate to Settings > Dev Center > API Credential Management.
View Greenhouse API crendentials
View Greenhouse API crendentials
2. Create a new API key for Workato. Select type: Harvest
Create a API credential for Workato
Create a API credential for Workato
3. Provide the necessary permissions to this API key. Learn more below.
Select API credential permissions
Select API credential permissions

Permissions

Ensure that you give this API credential the necessary permission. If permissions are not configure correctly, certain Greenhouse connector actions/trigger may not work as intended - even if the connection is successful. See the required permissions below.

# Permissions for Harvest API

The Greenhouse connector requires an API key that has permissions to access the specific Greenhouse objects. For example, the reject application action requires the Applications permission.

# List of Greenhouse Harvest API permissions

  • ✅ Applications
  • ✅ Candidates
  • ✅ Education
  • ✅ Jobs
  • ✅ Scheduled Interviews
  • ✅ Users

You can view and manage the permissions for each API key from the API Credential Management page.

Manage API credential permissions Manage API credential permissions

Didn’t find what you are looking for?
Search our resource library View getting started guides, tutorials, training videos, webinars and FAQ Ask our community View questions and answers from other users and Workato experts. File a support ticket File a support ticket for critical issues that require a higher level of support.
Privacy Terms (844) 469-6752 Workato 2021