---
title: "Greenhouse"
description: "把已录用的 Greenhouse 候选人作为即将入职的员工带入 Pyn，使用在 Greenhouse 中创建的 OAuth 凭据。"
sidebar:
  label: 概览
  order: 0
area: integrations
feature: greenhouse
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - integrations
  - integrations/ashby
  - integrations/sync-and-matching
  - flows/automations
intercom:
  - id: "16755703"
    title: Connect  to your HRIS (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755703-connect-to-your-hris-pyn-2
    note: draws on
translation:
  source: integrations/greenhouse/index.mdx
  sourceSha: 76f2c146e8a812d18b20a801e0dd0be0b5a2c600
---

Greenhouse 集成读取申请状态为已录用且有 offer 的候选人，并把他们创建为即将入职的员工，入职日期取自最近一份带有入职日期的 offer，同时带上招聘经理和你映射的自定义字段。入职前流程就能在他们的工作账户存在之前联系到他们。

## 开始之前

- 你是 Pyn 中的管理员或所有者。
- 一位 Greenhouse 管理员为 Pyn 创建带有 Harvest 读取权限范围的 OAuth 凭据，并把 **Client ID** 和 **Client Secret** 交给你。连接需要 OAuth 凭据；Harvest API 密钥无法通过验证。

![Connect to Greenhouse takes an OAuth Client ID and Client Secret, or a legacy API key.](https://support.pyn.ai/media/integrations/greenhouse/integrations-greenhouse-connect.png)

## 连接

1. 在 Pyn 中，打开左侧导航中的 **Settings**，然后打开 **Integrations** 下的 **Available**。

2. 选择 **Greenhouse** 磁贴。**Connect to Greenhouse** 对话框打开。

3. 粘贴 **Client ID** 和 **Client Secret**，并把 **API Key (legacy)** 留空；对话框显示“Greenhouse retired Harvest API keys on 31 August 2026 — a connection needs OAuth credentials created in Greenhouse.”

4. 选择 **Connect**。Pyn 检查凭据时，对话框显示 "Validating those credentials..."

5. 成功后，通知显示 "Your Greenhouse integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Greenhouse."

对话框可能显示的错误："Could not verify those credentials — they appear to be invalid or expired." / "The credentials are valid but lack the permissions needed. Grant the required scopes and try again." / "Enter either a client ID and secret, or a Harvest API key." / "An unexpected error occurred. Please check the credentials and try again. If the error persists, contact support."

## 同步的内容

Pyn 大约每小时从 Greenhouse 刷新一次。

| Pyn 属性 | 来自 Greenhouse |
| --- | --- |
| 显示名称、法定姓名、常用名 | 名、姓和常用名 |
| 工作邮箱 | 候选人类型为 work 的邮箱；绝不从其他类型推断 |
| 个人邮箱 | 个人邮箱，或任何非工作地址 |
| 入职日期 | 最近一份带有入职日期的 offer |
| 地点 | offer 的地点自定义字段 |
| 经理 | 招聘经理，一位 Greenhouse 用户 |
| 时区 | 候选人的时区 |
| 自定义字段 | 映射到 Greenhouse 自定义字段名称键的工作区扩展字段 |

录用者在 Directory 中显示为 **Upcoming**。关于 ATS 记录如何与随后到来的 HRIS 记录合并，见[同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)。

## 测试

第一次刷新后，打开[员工](https://support.pyn.ai/zh-cn/directory/employees/)并选择 **Upcoming** 视图。集成的 **History** 标签页列出每次刷新及其结果。

## 重新连接或断开连接

- **Reconnect** 打开 **Reconnect to Greenhouse** 以输入新凭据。"Your Greenhouse integration has been updated." 表示成功。
- **Deactivate** 暂停同步；**Activate** 恢复同步。

## 故障排除

| 你看到的 | 含义 |
| --- | --- |
| History："Error: Authentication failed, please reconnect" | 凭据已被撤销或密钥已过期。使用 OAuth 凭据重新连接。 |
| 缺少某位录用者 | 该申请未标记为已录用，或没有 offer。offer 中没有入职日期的录用者会在没有入职日期的情况下创建，不会显示为 Upcoming。 |
| 工作邮箱为空 | Greenhouse 中该候选人没有类型为 work 的邮箱；Pyn 不会猜测。 |

## 相关

- [集成](https://support.pyn.ai/zh-cn/integrations/)，查看目录。
- [Ashby](https://support.pyn.ai/zh-cn/integrations/ashby/)，查看另一个 ATS 集成。
- [同步频率与匹配](https://support.pyn.ai/zh-cn/integrations/sync-and-matching/)，了解 ATS 和 HRIS 记录如何合并。
- [自动化流程](https://support.pyn.ai/zh-cn/flows/automations/)，构建入职前流程。
