---
title: "BambooHR"
description: "会社のドメインでBambooHRを接続し、BambooHRのサインインを通してPynに従業員を読み取らせ、1時間ごとの更新と変更通知でDirectoryを最新に保ちます。"
sidebar:
  label: 概要
  order: 0
area: integrations
feature: bamboohr
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-02"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
intercom:
  - id: "11614355"
    title: Connect to BambooHR (Pyn 2)
    url: https://intercom.help/pyn/en/articles/11614355-connect-to-bamboohr-pyn-2
    note: replaces
  - id: "10100088"
    title: "BambooHR Error \"Insufficient Permissions\""
    url: https://intercom.help/pyn/en/articles/10100088-bamboohr-error-insufficient-permissions
    note: replaces
  - id: "6024101"
    title: Why is employee data from BambooHR not appearing in Pyn?
    url: https://intercom.help/pyn/en/articles/6024101-why-is-employee-data-from-bamboohr-not-appearing-in-pyn
    note: replaces
  - id: "6330100"
    title: Connect to BambooHR (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6330100-connect-to-bamboohr-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/bamboohr/index.mdx
  sourceSha: c75c1409d92ecf48831371f6ed3d872a20c0df1c
---

BambooHR連携は、BambooHR APIを通して従業員ディレクトリとカスタムレポートを読み取るので、スプレッドシートなしで入社日、部署、マネージャー、退職者がフローを動かします。BambooHRのWebhookが有効なワークスペースでは、BambooHRが更新と更新の間の変更もPynに通知します。

## 始める前に

- あなたがPynの管理者またはオーナーであること。
- BambooHRの会社ドメインを知っていること。BambooHRのアドレスの`.bamboohr.com`より前の部分です。
- APIアクセスがあり、同期したいフィールドを見られるアカウントでBambooHRにサインインできること。個人のログインより、従業員ではないサービスアカウントのほうが適しています。個人のログインはその人が退職すると使えなくなります。

![Connect to BambooHR asks for your Company Domain.](https://support.pyn.ai/media/integrations/bamboohr/integrations-bamboohr-connect.png)

## 接続する

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

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

3. **Company Domain**を入力します。`https://acme.bamboohr.com`のようにアドレス全体を貼り付けてもかまいません。Pynは`acme`だけを残します。「This is not a valid company domain.」は、BambooHRのサブドメインに見えないことを意味します。

4. **Connect**を選びます。BambooHRが開くので、サインインして**Allow Access**を選びます。

5. BambooHRからPynに戻ります。パネルには「You're connected. Syncing can take a few minutes. Check the journey map then!」と表示されます。代わりにBambooHRでアクセスを拒否した場合や、そこで時間がかかりすぎた場合は、**Installed**に戻り、**BambooHR wasn't connected**というタイトルのトーストが理由を伝えます。「You didn't grant access, so nothing was connected.」または「The sign-in took too long, so nothing was connected. Try again.」です。

## 同期されるもの

Pynは約1時間に1回更新します。レポートに変化がない実行は「Successfully integrated to BambooHR. No employee changes found」として記録されます。Webhookが有効なワークスペースでは、BambooHR自身の変更通知が届くたびに**History**に記録されます。**Details**タブには**Subdomain**、**Primary Source**（Custom ReportまたはDirectory）、**Last Refresh**、**Last Successful Refresh**が、**Advanced**タブには**Fields in Report**がフィールドごとの件数付きで表示されます。

| Pynのプロパティ | BambooHRでの元 |
| --- | --- |
| 表示名、正式名、呼び名 | Display name、Full name、Preferred name |
| 勤務先メールアドレス、個人メールアドレス | Work emailとHome email |
| 入社日 | Hire date。それより早いOriginal hire dateがあれば再入社の従業員として印が付きます |
| 退職日、ステータス | Termination date。Active以外のEmployment statusは非アクティブになります |
| 部署、部門、勤務地、役職 | 対応するBambooHRのフィールド |
| 雇用形態 | Employment history status |
| マネージャー | Supervisorの従業員id |
| 誕生日、国、郵便番号、タイムゾーン | Birthdayと住所。タイムゾーンは国と郵便番号から |

Pynが接続したアカウントがディレクトリしか読めない場合、パネルに警告が出ます。「This integration is pulling limited employee data from the BambooHR directory. To get a complete employee profile, have a BambooHR administrator reconnect this integration, or ask for expanded permissions.」フィールドのマトリクスは[HRISフィールド](https://support.pyn.ai/ja/integrations/hris-fields/)を参照してください。

## テストする

**Installed**でBambooHRのタイルを開き、メニュー（**...**）を開いて**Test Connection**を選びます。「Successfully tested the connection to BambooHR.」なら成功です。「An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists.」はサインインがもう使えないことを意味します。続いて[従業員](https://support.pyn.ai/ja/directory/employees/)を確認します。

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

- **Reconnect**は同じ会社ドメインでBambooHRのサインインをやり直します。接続したアカウントのパスワードが変わったときや、権限が広げられたときに使います。
- **Deactivate**は同期を止め、**Activate**で再開します。**Archive**は連携をInstalledから取り除きます。同期済みの従業員は残ります。どちらかが失敗すると、トーストに**Could not deactivate the integration**または**Could not archive the integration**と表示され、何も変わりません。

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

| 表示されるもの | 意味 |
| --- | --- |
| History：「Error: Insufficient permissions to access BambooHR」 | 接続したアカウントのアクセスレベルがAPIまたはフィールドの権限を失いました。BambooHRで**Access Levels > Custom Levels**を開いてそのレベルを選び、**Access Level Settings**の下で**Settings > Company Field Settings**を許可してから再接続してください。 |
| History：「Error: Authentication failed, please reconnect」 | サインインの期限が切れたか取り消されました。再接続してください。 |
| History：「Could not connect to BambooHR, please reconnect」 | BambooHRが接続を拒否しました。再接続し、繰り返すならサポートに連絡してください。 |
| History：「BambooHR returned data in an unexpected format」（黄色） | 更新でPynが読めない応答が返りました。通常は一度きりなので、連携はアクティブなまま次の更新で再試行します。毎回繰り返すならサポートに連絡してください。 |
| 誰かが退職した後に従業員が更新されなくなった | 連携がその人のログインで接続されていました。従業員ではないアカウントで再接続してください。 |
| 入社日などのフィールドが空 | BambooHRで空か、アカウントがそれを見られません。Advancedのフィールドの件数を確認してください。 |

## 関連ページ

- [連携](https://support.pyn.ai/ja/integrations/)：カタログについてです。
- [HRISフィールド](https://support.pyn.ai/ja/integrations/hris-fields/)：フィールドのマトリクスについてです。
- [同期の頻度とマッチング](https://support.pyn.ai/ja/integrations/sync-and-matching/)：スケジュールと照合についてです。
