---
title: "Ashby"
description: "採用が決まったAshbyの候補者を入社予定の従業員としてPynに取り込み、プレボーディングのフローを初日より前に始められるようにします。"
sidebar:
  label: 概要
  order: 0
area: integrations
feature: ashby
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - integrations
  - integrations/greenhouse
  - integrations/sync-and-matching
  - flows/automations
translation:
  source: integrations/ashby/index.mdx
  sourceSha: d7b66f45596ed73fca1ddce214dfa31498448362
---

Ashby連携は、採用済みの応募と入社日のある有効なオファー（承諾済みのオファーが優先されます）を持つ候補者を読み取り、入社日、役職、部署、勤務地、採用マネージャー付きの入社予定の従業員として作成します。入社日をトリガーにしたプレボーディングのフローは、仕事用アカウントができる前に個人のアドレスでその人に届きます。

## 始める前に

- あなたがPynの管理者またはオーナーであること。
- Ashbyの管理者が**Admin > API Keys**で、**Candidates**、**Offers**、**Organization**への読み取りアクセスを持つAPIキーを作成すること。**Jobs**への読み取りアクセスは任意で、応募ではなく求人に設定された採用マネージャーを取得します。機密の求人への採用を含めるには、機密の求人とプロジェクトへのアクセスも許可します。

![Connect to Ashby asks for an API Key.](https://support.pyn.ai/media/integrations/ashby/integrations-ashby-connect.png)

## 接続する

1. Pynで左のナビゲーションの**Settings**を開き、**Integrations**の下の**Available**を開きます。

2. **Ashby**のタイルを選びます。**Connect to Ashby**ダイアログが開きます。

3. **API Key**を貼り付けます。

4. **Connect**を選びます。Pynが確認している間、ダイアログには「Validating that API key...」と表示されます。

5. 成功すると、通知に「Your Ashby integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Ashby.」と表示されます。

ダイアログに表示されうるエラー：「Could not verify that API key — it appears to be invalid or deactivated.」/「The API key is valid but lacks the permissions needed. Grant it read access to Candidates, Offers and Organization and try again.」/「Enter an Ashby API key.」/「An unexpected error occurred. Please check the API key and try again. If the error persists, contact support.」

## 同期されるもの

PynはAshbyから約1時間に1回更新します。採用済みの応募ごとに次を読み取ります。

| Pynのプロパティ | Ashbyでの元 |
| --- | --- |
| 表示名、正式名 | 候補者の名前 |
| 勤務先メールアドレス、個人メールアドレス | 候補者の勤務先と個人の連絡先メールアドレス |
| 入社日 | オファーの最新版の入社日 |
| 役職 | 応募の求人 |
| 部署、勤務地 | 求人の部署名と勤務地名 |
| マネージャー | 求人の採用マネージャー（Ashbyのユーザー） |
| タイムゾーン | 候補者のタイムゾーン |
| カスタムフィールド | Ashbyのカスタムフィールドに対応付けられたワークスペース拡張。オファー、応募、候補者の順に読み取ります |

採用された人は入社日まで**Upcoming**としてDirectoryに表示されます。後から届くHRISのレコードとの照合の仕組みは[同期の頻度とマッチング](https://support.pyn.ai/ja/integrations/sync-and-matching/)を参照してください。

## テストする

最初の更新の後、[従業員](https://support.pyn.ai/ja/directory/employees/)を開いて**Upcoming**ビューを選びます。最近採用された人が入社日付きで並んでいるはずです。連携の**History**タブに各更新が表示されます。

## 再接続または切断する

- メニュー（**...**）の**Reconnect**は、新しいキーを貼り付ける**Reconnect to Ashby**を開きます。「Your Ashby integration has been updated.」なら成功です。
- **Deactivate**は同期を一時停止し、**Activate**で再開します。

## トラブルシューティング

| 表示されるもの | 意味 |
| --- | --- |
| History：「Error: Authentication failed, please reconnect」 | キーがAshbyで無効化されました。新しいキーを作成して再接続してください。 |
| History：「Error: Insufficient Ashby permissions」 | キーに読み取りスコープが足りません。Candidates、Offers、Organizationを許可してください。 |
| 採用された人がいない | オファーが辞退、取り消し、または撤回されたか、入社日がないか、求人が機密でキーから見えません。 |
| 採用マネージャーが空 | Jobsへの読み取りアクセスを許可するか、応募に採用マネージャーを設定してください。 |

## 関連ページ

- [連携](https://support.pyn.ai/ja/integrations/)：カタログについてです。
- [Greenhouse](https://support.pyn.ai/ja/integrations/greenhouse/)：もう1つのATS連携についてです。
- [同期の頻度とマッチング](https://support.pyn.ai/ja/integrations/sync-and-matching/)：ATSとHRISのレコードがどう統合されるかについてです。
- [オートメーション](https://support.pyn.ai/ja/flows/automations/)：入社日を基準にしたプレボーディングのフローを作るにはこちらです。
