> 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/hris/greenhouse-onboarding.md).
# Greenhouse Onboarding
Greenhouse Onboarding is a post-hire employee management product from Greenhouse, separate from Greenhouse Recruiting. It stores new hire records, start dates, roles, and departments from the moment an offer is accepted. Connecting Greenhouse Onboarding to Harmony enables automated IT provisioning triggered by new hire events, employee lifecycle management driven by hiring data, and streamlined day-one access for new employees.
{% hint style="info" %}
This integration connects to **Greenhouse Onboarding**, a separate product from Greenhouse Recruiting (ATS). Your organization must have Greenhouse Onboarding enabled to use this integration.
{% endhint %}
{% hint style="info" %}
**Note:** Greenhouse Onboarding is a distinct integration from the existing Greenhouse ATS connection used for job listings and employee referrals. Connecting Greenhouse Onboarding does not affect your existing Greenhouse ATS integration in any way.
{% endhint %}
#### What the Greenhouse Onboarding integration enables
| Capability | Description |
| ----------------------- | ---------------------------------------------------------------------------------------------------- |
| Automated Onboarding | Trigger IT provisioning workflows when new hires are confirmed in Greenhouse Onboarding |
| Employee Data Sync | Sync employee profiles, start dates, departments, and roles from Greenhouse Onboarding |
| Role-Based Provisioning | Assign IT resources based on department, role, and employment type |
| Lifecycle Automation | Automate IT tasks for role changes and department transfers |
| Organizational Sync | Keep employee data synchronized across IT systems using Greenhouse Onboarding as the source of truth |
#### Prerequisites
* **Greenhouse Onboarding Super Admin access**: Only Super Admins can create API credentials in Greenhouse Onboarding
* **Greenhouse Onboarding product**: Your organization must have Greenhouse Onboarding (separate from Greenhouse Recruiting)
* **Harmony Account**: Active Harmony workspace
#### Connect Greenhouse Onboarding to Harmony
**Step 1: Generate API Credentials in Greenhouse Onboarding**
1. Log in to Greenhouse Onboarding at `https://onboarding.greenhouse.io`
2. Navigate to **Settings** > **API Management**
3. Click **Create New API Key**
4. Enter a name: `Harmony Integration`
5. Click **Create** and copy both the **Access Key** and **Secret Key** - the Secret Key is shown only once
**Step 2: Navigate to Integrations**
1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Greenhouse Onboarding** under **HRIS** and click **Connect**
**Step 3: Enter API Credentials**
1. Enter your **Access Key**
2. Enter your **Secret Key**
3. Click **Connect**
#### What Harmony Syncs
**From Greenhouse Onboarding:**
* Employee profiles (first name, last name, preferred name, work email)
* Job information (title, department)
* Employment dates (start date, termination date)
* Employment status (active, terminated)
* Work location and country
* Phone number
* Manager name and reporting hierarchy
{% hint style="info" %}
Employment status in Greenhouse Onboarding is a free-form, per-tenant string. Harmony maps `Full-time` and `Part-time` to **Active**, and `Terminated` to **Terminated**. Custom statuses configured in your Greenhouse Onboarding account are mapped to **Other** until Harmony adds explicit support for them.
{% endhint %}
{% hint style="info" %}
Full employee data sync and onboarding trigger support are coming in a follow-up update. Stay tuned for additional capabilities as this integration continues to expand.
{% endhint %}
#### Use Cases
Day-One Ready Onboarding
Trigger complete IT setup when a new hire is added in Greenhouse Onboarding, ensuring accounts and equipment are ready on their first day
Start Date-Based Provisioning
Schedule IT provisioning in advance using the employee start date from Greenhouse Onboarding, so access is ready exactly when needed
Role Change Management
Automatically adjust access when employees change roles or departments in Greenhouse Onboarding
Seamless Offboarding
Automate access revocation and asset recovery when a termination date is set in Greenhouse Onboarding
---
# 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/hris/greenhouse-onboarding.md?ask=&goal=
```
`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.