> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/it-service-management/greenhouse-ats.md).

# Greenhouse ATS

The Greenhouse integration connects Harmony to your Greenhouse Applicant Tracking System (ATS), making candidate and job data available directly within your Harmony agent workflows. This integration is part of the ATS integrations category, which sits alongside your existing HR and productivity tools.

Once connected, your agents can work with Greenhouse data the same way they interact with any other integrated platform - no manual exports or context switching required.

### Prerequisites

Before setting up the integration, make sure you have the following available from your Greenhouse account:

* **API key** - your Greenhouse API key, used to authenticate Harmony with Greenhouse
* **Job board URL** - the URL of your Greenhouse job board
* **User ID** - your Greenhouse user identifier

All three values are required. The integration will not save if any field is missing or invalid.

### Connecting Greenhouse to Harmony

To set up the Greenhouse integration:

1. In Harmony, navigate to **Integrations** and select the **ATS** category.
2. Locate the **Greenhouse** integration and click **Connect**.
3. Enter your **API key**, **Job board URL**, and **User ID** in the corresponding fields.
4. Click **Save** to validate and activate the connection.

If all three fields pass validation, the integration will be activated and Greenhouse data will become available to your Harmony agent workflows.

### Using Greenhouse Data in Workflows

Once connected, Greenhouse behaves like any other integrated platform in Harmony. You can reference Greenhouse data - such as job listings and applicant information - as inputs or context within your agent workflows, enabling automated recruiting and hiring processes without leaving Harmony.

### Troubleshooting

If the integration fails to save, check the following:

* Confirm that your **API key** is active and has the necessary permissions in Greenhouse.
* Verify that the **Job board URL** is correctly formatted and points to your Greenhouse job board.
* Ensure your **User ID** is accurate and corresponds to a valid Greenhouse user.

After correcting any issues, attempt to save the integration again. If the problem persists, contact Harmony support with the error details.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/integrations/it-service-management/greenhouse-ats.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.