ヘルプセンターに戻る

HubSpotとのOAuth連携

TsunavoのワークスペースにHubSpotアカウントを連携する手順と、Tsunavoが求める権限(スコープ)を説明します。

約10分
更新: 2026-11-05
この記事でできること
  • TsunavoのワークスペースにHubSpotアカウントを連携できます
  • Tsunavoが求める権限(スコープ)と、その用途が分かります
前提条件
  • Tsunavoのワークスペースを作成済みであること
  • Tsunavoのワークスペースで、オーナーまたは管理者のロールを持っていること
  • HubSpotアカウントで、アプリのインストールを承認できる権限があること

OAuth連携とは

パスワードを渡さずに、アプリ同士の接続を許可するしくみです。

  • TsunavoにHubSpotのパスワードを入力する必要はありません
  • Tsunavoは、HubSpotの許可画面で承認した権限の範囲でだけHubSpotにアクセスします
  • 連携はTsunavoの画面からも、HubSpotの画面からも解除できます

手順

1TsunavoでHubSpotの連携画面を開く

左側のメニューで①「コネクター」を開き、②「HubSpot」のカードを押します。メニューの「コネクター」の下にある「HubSpot」から開くこともできます。

まだ連携していない場合は、ダッシュボードのスタートアップガイドにある「HubSpotを接続」からも開けます(下の2枚目の画像の①)。

TsunavoでHubSpotの連携画面を開く
ボタンが表示されないとき

連携の操作は、オーナーまたは管理者だけが行えます。ほかのロールでは、ボタンの代わりに案内文が表示されます。「HubSpot連携は現在このワークスペースではご利用いただけません」と表示される場合は、Tsunavoサポートへお問い合わせください。

ダッシュボードのスタートアップガイド。①「HubSpotを接続」の行を押すとHubSpot連携画面が開く
2「HubSpotを連携する」を押す

「HubSpotアカウントを連携しましょう」と表示された画面で、①「HubSpotを連携する」を押します。

HubSpotの画面に移ります。HubSpotにログインしていない場合は、ログインします。

「HubSpotを連携する」を押す
3連携するHubSpotアカウントを選ぶ

「TsunavoをHubSpotに接続しています」の画面で、①の一覧から連携するHubSpotアカウント(ポータル)を選びます。アカウントは名前、ドメイン、IDで検索できます。

アカウントによっては、選んだあとに追加のログインを求められます。

連携するHubSpotアカウントを選ぶ
アカウントを間違えないでください

本番用とテスト用のHubSpotアカウントを取り違えないよう注意してください。あとから変える場合は、いったん連携を解除してから連携し直します。

4権限を確認して「アプリを接続」を押す
  1. ①「必須」の欄で、Tsunavoが求める権限を確認します。権限の一覧と用途は、このあとの「必要な権限(スコープ)」を参照してください
  2. ②の規約とプライバシーポリシーへの同意にチェックが入っていることを確認します
  3. ③「アプリを接続」を押します

接続すると、TsunavoのHubSpot連携画面に戻ります。

権限を確認して「アプリを接続」を押す
うまくいったかの確認
  • HubSpot連携画面の①「接続ステータス」が「接続中」になり、連携したアカウントのPortal IDとHub名が表示されている
  • ②「接続テスト」を押すと、接続を確認できたと表示される

コネクターの一覧では、HubSpotのカードに「接続済み」と表示されます。

連携後のHubSpot連携設定画面。①接続ステータスが「接続中」でPortal IDとHub名が表示されている、②診断の「接続テスト」ボタン

必要な権限(スコープ)

Tsunavoは、連携のときに次の権限を求めます。ここにない任意の権限は求めません。

権限

用途

oauth

OAuth認証の基本権限

crm.objects.contacts.read

コンタクトの読み取り

crm.objects.contacts.write

コンタクトの更新(LINE連携の結果を書き込む)

crm.schemas.contacts.read

コンタクトのプロパティ定義の読み取り

crm.schemas.contacts.write

Tsunavo用のプロパティの作成

crm.lists.read

リストとリストメンバーの読み取り

timeline

LINEのイベントをタイムラインに記録

HubSpotに書き込むプロパティ

Tsunavoが書き込むHubSpotのコンタクトプロパティは、tsunavo_link_url、tsunavo_line_primary_channel_id、tsunavo_line_primary_user_id の3つです。それぞれの内容は「HubSpotに登録されるプロパティ一覧」を参照してください。

HubSpot Marketplaceからインストールする場合

HubSpot MarketplaceからTsunavoをインストールした場合は、次の流れで連携します。

  1. HubSpotの許可画面でアプリを承認すると、HubSpotのインストール完了画面に戻ります。この時点では、Tsunavoのワークスペースとの連携はまだ終わっていません
  2. インストール完了画面の「アプリを開く」を押し、Tsunavoにログインします
  3. 連携するワークスペースを選びます。ワークスペースがまだない場合は、ここで作成します

連携が終わると、ワークスペースの初期設定が残っていればその続きに進みます。初期設定が終わっていれば、HubSpot連携画面に進みます。

うまくいかないとき

うまくいかない場合
エラー: "HubSpotの許可画面で承認できない"

原因: 使っているHubSpotユーザーに、アプリのインストールを承認する権限がありません。

解決策: HubSpotの管理者に承認を依頼するか、承認できる権限のあるユーザーでやり直してください。

エラー: "「HubSpotを連携する」ボタンが表示されない"

原因: Tsunavoのワークスペースで、オーナーまたは管理者のロールを持っていません。

解決策: オーナーまたは管理者に連携を依頼するか、ロールの変更を依頼してください。

エラー: "Marketplaceからインストールしたのに、Tsunavoに連携されていない"

原因: HubSpotのインストール完了画面で止まり、Tsunavo側の操作がまだ終わっていません。

解決策: HubSpotのインストール完了画面の「アプリを開く」から、Tsunavoでワークスペースを選んで連携を終えてください。うまくいかない場合は、Tsunavoの「コネクター」→「HubSpot」から「HubSpotを連携する」をやり直してください。

エラー: "選んだHubSpotアカウントで連携できない"

原因: そのHubSpotアカウントは、別のTsunavoワークスペースですでに連携されています。1つのHubSpotアカウントは、1つのワークスペースにだけ連携できます。

解決策: もう一方のワークスペースで連携を解除してから連携するか、別のHubSpotアカウントを選んでください。

HubSpotとのOAuth連携 | Tsunavo ヘルプセンター