> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SmartHR

> SmartHRとの連携手順です。

## サポートする機能

<Badge color="blue">従業員マスター連携</Badge> <Badge color="blue">アカウント削除</Badge> <Badge color="blue">アカウント作成</Badge>

## SmartHRとの連携について

SmartHRとの連携については、OAuthを利用した連携とAPI keyを利用した方法があります。

これから新しく連携するお客様は連携が簡単なOAuthでの連携をご利用いただくことを推奨いたします。

<Warning>
  **【重要】SmartHR仕様変更にともなう権限確認のお願い**

  OAuth連携では、連携時にログインしたSmartHRアカウントの権限グループの範囲でのみ、従業員情報を取得できます。

  2026年8月頃に予定されているSmartHRのアップデートにより、従業員情報の権限設定が「本人（自分自身）」と「本人以外（他従業員）」に分かれて管理できるようになります。

  これにともない、Adminaが取得する項目（氏名・メールアドレス・カスタム項目など）が、「本人」「本人以外」の両方で【閲覧可】になっているかご確認ください。

  確認方法：SmartHRの設定 > 権限設定から、連携アカウントが属する権限グループの設定をご確認ください。

  注意事項：いずれか一方でも「閲覧不可」になっていると、エラーは表示されませんが該当項目が同期されなくなります。
</Warning>

## 事前準備

### SmartHRへのログイン方法

[SmartHRログインページ](https://app.smarthr.jp/login)にて、メールアドレス・パスワードを入力しログインします。

<img src="https://mintcdn.com/moneyforwardi/5aO90x6f2w9Vx4XQ/images/integrations/zyl6g8sbgx/1716967342074.png?fit=max&auto=format&n=5aO90x6f2w9Vx4XQ&q=85&s=bc8d5a1967a53d1441af9d13ea84145e" alt="SmartHRログイン画面" width="682" height="636" data-path="images/integrations/zyl6g8sbgx/1716967342074.png" />

### OAuthでの連携（推奨）

OAuthで連携する場合、次のリンクからSmartHR Plusにアクセスし、SmartHRとの連携を許可してください。

[SaaS管理: SmartHR Plus （スマートHRプラス）](https://www.smarthr.plus/apps/admina)

1. 連携をはじめる をクリックします。

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/zyl6g8sbgx/1716884103805.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=9927b7255c3ad250cad14945f561ede9" alt="連携をはじめる" width="1558" height="720" data-path="images/integrations/zyl6g8sbgx/1716884103805.png" />

2. SmartHRに管理者権限のアカウントでログインします。ログインが完了すると事前準備は完了ですので、次のインテグレーションのセットアップの項に進んでください。

   <img src="https://mintcdn.com/moneyforwardi/5aO90x6f2w9Vx4XQ/images/integrations/zyl6g8sbgx/1716884142745.png?fit=max&auto=format&n=5aO90x6f2w9Vx4XQ&q=85&s=57cd43d23ab675b95b58077163b8231a" alt="管理者アカウントでログイン" width="1722" height="418" data-path="images/integrations/zyl6g8sbgx/1716884142745.png" />

### API keyでの連携

API keyで連携する場合は、以下の項目を確認します。

**ワークスペースキーの取得方法**

[SmartHR](https://app.smarthr.jp/login)にログイン後、**URLの一部**がワークスペースキーとなりますので、コピー・保存しておきます。

`https://{ワークスペースキー}.smarthr.jp/` （https\:// は含みません）

<img src="https://mintcdn.com/moneyforwardi/5aO90x6f2w9Vx4XQ/images/integrations/zyl6g8sbgx/1667902884880.png?fit=max&auto=format&n=5aO90x6f2w9Vx4XQ&q=85&s=7a8e381f6953a9360721c14131465d0f" alt="ワークスペースキー" width="1126" height="454" data-path="images/integrations/zyl6g8sbgx/1667902884880.png" />

**アクセスキーの取得方法**

**アクセストークンがアクセスキー**となります。次のSmartHR社のサイトを参考にアクセストークンを発行してください。

[アクセストークンの発行方法](https://knowledge.smarthr.jp/hc/ja/articles/360026266033)

<Info>
  ・付与する権限は、従業員情報（/crews）および、アカウント（/users）の参照権限が必須です。\
  ・連携時にカスタムフィールド項目のメールアドレスを取得する場合、追加したカスタム従業員項目の参照権限が必要です。
</Info>

## インテグレーションのセットアップ

1. インテグレーション画面にて、**SmartHR**で検索します。

2. \[OAuth]または\[API]で連携できます。

   a. **OAuthでの連携（推奨）**：タブからOAuthをクリックして \[**連携する**] をクリックします。以下の項目を設定、選択ください。

   | 項目                        | 説明                                                                                                                                                                                  |
   | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | メールアドレスのカスタム従業員項目名（オプション） | カスタム従業員項目のメールアドレスを取得する場合に、\*\*カスタム従業員項目名（下記画像の赤枠部分）\*\*を入力します。指定した場合、プライマリアドレスとして取得します。カンマ区切りで複数の項目の入力が可能です（先頭の項目がプライマリアドレスとして取得されます）。連携すると、カスタム従業員項目のメールアドレスで自動的に名寄せ（マージ）が可能となります。 |
   | ビジネスネームを優先表示する            | SmartHRでビジネスネームが設定されている場合、ユーザー名にビジネスネームを設定します。                                                                                                                                      |

   <img src="https://mintcdn.com/moneyforwardi/GO9TGGYxuUpFEkvm/images/integrations/zyl6g8sbgx/1716885053422.png?fit=max&auto=format&n=GO9TGGYxuUpFEkvm&q=85&s=aac2faa18f613c04a8b5cc824e0f304e" alt="OAuth連携画面" width="482" height="670" data-path="images/integrations/zyl6g8sbgx/1716885053422.png" />

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/zyl6g8sbgx/1668653254526.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=0723c3ac0d87fdaf2507467fd706e151" alt="カスタム従業員項目" width="3034" height="1364" data-path="images/integrations/zyl6g8sbgx/1668653254526.png" />

   b. **APIキーでの連携**：タブから\[API]を選択し、次の各項目の値を入力し、**連携する**をクリックします。

   | 項目                        | 説明                                                                                                                                                                                  |
   | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | ワークスペース名                  | 任意の文字列（会社名など）                                                                                                                                                                       |
   | ワークスペースキー                 | 前の手順で取得した**ワークスペースキー**                                                                                                                                                              |
   | アクセスキー                    | 前の手順で発行した**APIキー**                                                                                                                                                                  |
   | メールアドレスのカスタム従業員項目名（オプション） | カスタム従業員項目のメールアドレスを取得する場合に、\*\*カスタム従業員項目名（下記画像の赤枠部分）\*\*を入力します。指定した場合、プライマリアドレスとして取得します。カンマ区切りで複数の項目の入力が可能です（先頭の項目がプライマリアドレスとして取得されます）。連携すると、カスタム従業員項目のメールアドレスで自動的に名寄せ（マージ）が可能となります。 |
   | ビジネスネームを優先表示する            | SmartHRでビジネスネームが設定されている場合、ユーザー名にビジネスネームを設定します。                                                                                                                                      |

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/zyl6g8sbgx/1716885311548.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=9249da0c43a5dcaad988274706125827" alt="APIキー連携画面" width="487" height="911" data-path="images/integrations/zyl6g8sbgx/1716885311548.png" />

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/zyl6g8sbgx/1668653254526.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=0723c3ac0d87fdaf2507467fd706e151" alt="カスタム従業員項目" width="3034" height="1364" data-path="images/integrations/zyl6g8sbgx/1668653254526.png" />

3. SmartHRとの連携が成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。正常に完了しない場合は、まず [SaaSとの連携に失敗する場合の対処法](/it-management/saas-management/93nahw45is-trouble) に記載のステップをお試しください。それでも解決しない場合は、[ご提供いただきたい情報](/it-management/saas-management/93nahw45is-trouble#info-to-provide) をご確認のうえ、[サポート窓口](/contact-support)までお問い合わせください。

## SmartHR連携時の取得データについて

SmartHRから連携している項目については[SmartHR Plus](https://www.smarthr.plus/apps/admina)に記載しておりますので、ご覧ください。

<img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/zyl6g8sbgx/1716885828041.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=488bcfeba1047abb77fc59a02c41180b" alt="SmartHR Plus連携項目" width="861" height="838" data-path="images/integrations/zyl6g8sbgx/1716885828041.png" />