> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Greenhouse

> Configure data exchange between CloudTalk and Greenhouse to ensure your data stays up to date.

> [!NOTE]
>
> This guide will help you connect Greenhouse with CloudTalk in just a few simple steps.

**User level**: Admin

***

## Before You Start

Before setting up the Greenhouse integration, make sure you have the following ready:

* **A Greenhouse account** with access to the Dev Center and API Credential Management.

* **A Greenhouse Harvest API key** with the following permissions enabled: `GET: Retrieve Candidate`, `GET: List Candidates`, `POST: Add Note`, and `GET: List Users`. You can generate this in Greenhouse under **Dev Center > API Credentials**.

* **Your Greenhouse subdomain** which is the first part of your Greenhouse URL. For example, if your URL is `yourcompany.greenhouse.io`, your subdomain is `yourcompany`.

* **The email address you use in CloudTalk must match exactly with the email address in your Greenhouse account**. If the emails do not match, synchronization will not work correctly.

## Configure Greenhouse

1. In your CloudTalk Dashboard, navigate to **Settings > Integrations**

2. Find **Greenhouse** and click **+ Add**

   ![](https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/816abe4c8cee-screenshot-2025-08-05-at-11-28-19.png?fit=max\&auto=format\&n=Ql3WX5wAKbGZniqk\&q=85\&s=0358c837ab8eca54ddbebc937eb14509)

3. You’ll be asked to provide the following:

   * **Your authentication name**

   * **API Key**

   * **Greenhouse Subdomain**

   ![](https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/db671a70a6a3-screenshot-2025-08-05-at-11-36-37.png?fit=max\&auto=format\&n=Ql3WX5wAKbGZniqk\&q=85\&s=e727111e6038419a7a39b5f293474787)

4. After filling in the details, click **Submit**.

***

### Where to Find Your Credentials

#### API Key

To generate an API key in Greenhouse:

1. Go to **Dev Center** > **API Credentials**

2. Click **Create new API credentials**

3. In the popup:

   * Set **API type** to `Harvest`

   * Set **Partner** to `Custom`

   * Add a description

4. Click **Manage permissions** to proceed and copy the key on the next screen

![](https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/c1af83025914-screenshot-2025-08-05-at-10-53-45.png?fit=max\&auto=format\&n=Ql3WX5wAKbGZniqk\&q=85\&s=c7833423dc1b703a65517ece653edc0c)

#### API Key Permissions

When configuring the Greenhouse integration, it’s important to ensure that the correct permissions are applied to your Harvest API key. These permissions are not configurable at the moment of key creation, but they must be edited afterward.

To update the API key permissions:

1. Go to **Greenhouse Settings**.

2. Navigate to the **Dev Center > API Credential Management**.

3. Locate your **CloudTalk API key**, then click the **Edit** button next to it.

4. In the **Manage permissions** section, ensure the following permissions are enabled:

* `GET: Retrieve Candidate`

* `GET: List Candidates`

* `POST: Add Note`

* `GET: List Users`

These permissions are required to allow CloudTalk to display candidates, log call activity, and associate notes with the correct users in Greenhouse.

#### Greenhouse Subdomain

This is the first part of your Greenhouse URL.

Example:

```text theme={"system"}
yourcompany.greenhouse.io → Subdomain = yourcompany
```

***

## Customize Integration

Once credentials are submitted:

1. Toggle the Integration Status to **Active**.

2. Add a **Caption** to name the integration instance.

3. Apply a **Contact tag** to synced candidates in CloudTalk if needed.

4. Select which **numbers** should be used for calls and SMS.

5. Click **Save** to confirm.

![](https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/4a62b77d349f-screenshot-2025-08-05-at-11-39-02.png?fit=max\&auto=format\&n=Ql3WX5wAKbGZniqk\&q=85\&s=c64a5ad5c5d6df0de3eda70ea7b80d2f)

## Disconnect Greenhouse Integration

If you need to remove the integration:

1. Go to **Settings > Integrations** in your CloudTalk Dashboard

2. Locate **Greenhouse** and click **Configure**

3. Scroll down and click **Delete Integration**

4. Type **DELETE** when prompted and confirm

The integration will now be removed from CloudTalk.

![](https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/11937842/1683fba300ba-screenshot-2025-08-05-at-10-50-23.png?fit=max\&auto=format\&n=Ql3WX5wAKbGZniqk\&q=85\&s=72e6ddaa54dc41684faaf49e0448f36a)

***

*Need help or have a question?* Just reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we’re here for you.


## Related topics

- [Using CloudTalk with Greenhouse](https://help.cloudtalk.io/en/articles/11938372-using-cloudtalk-with-greenhouse.md)
- [Configure Attio](https://help.cloudtalk.io/en/articles/16815852-configure-attio.md)
- [Configure Zoho](https://help.cloudtalk.io/en/articles/3490662-configure-zoho.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.