メインコンテンツへスキップ

サポートする機能

従業員マスター連携 アカウント削除 アカウント作成

SmartHRとの連携について

SmartHRとAdminaの連携については、OAuthを利用した連携とAPI keyを利用した方法があります。 これから新しく連携するお客様は連携が簡単なOAuthでの連携をご利用いただくことを推奨いたします。

事前準備

SmartHRへのログイン方法

SmartHRログインページにて、メールアドレス・パスワードを入力しログインします。 SmartHRログイン画面

OAuthでの連携(推奨)

OAuthで連携する場合、次のリンクからSmartHR Plusにアクセスし、AdminaとSmartHRの連携を許可ください。 SaaS管理:マネーフォワードAdmina SmartHR Plus (スマートHRプラス)
  1. 連携をはじめる をクリックします。
連携をはじめる
  1. SmartHRに管理者権限のアカウントでログインします。ログインが完了すると事前準備は完了ですので、次のインテグレーションのセットアップの項に進んでください。
管理者アカウントでログイン

API keyでの連携

API keyで連携する場合は、以下の項目を確認します。 ワークスペースキーの取得方法 SmartHRにログイン後、URLの一部がワークスペースキーとなりますので、コピー・保存しておきます。 https://{ワークスペースキー}.smarthr.jp/ (https:// は含みません) ワークスペースキー アクセスキーの取得方法 アクセストークンがアクセスキーとなります。次のSmartHR社のサイトを参考にアクセストークンを発行してください。 アクセストークンの発行方法
・付与する権限は、従業員情報(/crews)および、アカウント(/users)の参照権限が必須です。
・連携時にカスタムフィールド項目のメールアドレスを取得する場合、追加したカスタム従業員項目の参照権限が必要です。

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

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

OAuthでの連携(推奨)

タブからOAuthをクリックして [連携する] をクリックします。以下の項目を設定、選択ください。 OAuth連携画面
  • メールアドレスのカスタム従業員項目名(オプション): カスタム従業員項目のメールアドレスを取得する場合に、**カスタム従業員項目名(下記画像の赤枠部分)**を入力します。指定した場合、プライマリアドレスとして取得します。カンマ区切りで複数の項目の入力が可能です(先頭の項目がプライマリアドレスとして取得されます)。連携すると、カスタム従業員項目のメールアドレスで自動的に名寄せ(マージ)が可能となります。
カスタム従業員項目
  • ビジネスネームを優先表示する: SmartHRでビジネスネームが設定されている場合、Adminaのユーザー名ビジネスネームを設定します。

APIキーでの連携

タブから[API]を選択し、次の各項目の値を入力し、連携するをクリックします。 APIキー連携画面
  • ワークスペース名: 任意の文字列(会社名など)
  • ワークスペースキー: 前の手順で取得したワークスペースキー
  • アクセスキー: 前の手順で発行したAPIキー
  • メールアドレスのカスタム従業員項目名(オプション): カスタム従業員項目のメールアドレスを取得する場合に、**カスタム従業員項目名(下記画像の赤枠部分)**を入力します。指定した場合、プライマリアドレスとして取得します。カンマ区切りで複数の項目の入力が可能です(先頭の項目がプライマリアドレスとして取得されます)。連携すると、カスタム従業員項目のメールアドレスで自動的に名寄せ(マージ)が可能となります。
  • ビジネスネームを優先表示する: SmartHRでビジネスネームが設定されている場合、Adminaのユーザー名ビジネスネームを設定します。
カスタム従業員項目 SmartHRとの連携に成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。 正常に完了しない場合は、インテグレーション画面のステータスタブから編集し、再度連携をお試しください。 解決しない場合はチャットにてお問い合わせください🙏 SmartHRの連携概要については連携ページをご覧ください。

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

SmartHRからAdminaに連携している項目についてはSmartHR Plusに記載しておりますので、ご覧ください。 SmartHR Plus連携項目
最終更新日 2026年6月29日