HubSpot認証情報

CRMコンタクト管理のためのHubSpotアクセストークンを設定

HubSpotのアクセストークンを設定して、Jinba FlowのワークフローからCRMのコンタクトを管理します。

​

前提条件

• CRMにアクセスできるHubSpotアカウント
• そのアカウントでサービスキーまたは非公開アプリを作成する権限

​

HubSpotアクセストークンの作成

HubSpotには2種類の静的トークンがあり、どちらも本ツールで使用できます。発行されるトークンの形式は同じなので、アカウントで利用できる方を選んでください。

非公開アプリは移動しました。 HubSpotが開発者プラットフォームを再編し、非公開アプリは 旧アプリ（Legacy apps） の配下に移りました。既存の非公開アプリのトークンは引き続き 有効で、廃止予定も告知されていませんが、新規の連携は REST API アクセス専用に設計された サービスキー を使う方向に案内されています。

​

方法A: サービスキー（推奨）

1. HubSpotにサインイン
2. 開発（Development） → キー（Keys） → サービスキー（Service keys） を開く（または 設定 → 連携 → サービスキー）
3. サービスキーを作成 をクリックし、名前を入力（例: Jinba Flow）
4. スコープを追加 から crm.objects.contacts.read と crm.objects.contacts.write を選択
5. 作成 をクリックし、生成されたトークンをコピー

サービスキーは現在パブリックベータです。Webhookや UI 拡張には使用できず、REST API リクエスト専用ですが、本ツールに必要なのはそれだけです。

​

方法B: 旧アプリ（従来の非公開アプリ）

1. HubSpotにサインイン
2. 開発（Development） → 旧アプリ（Legacy apps） を開く（以前 連携 → 非公開アプリ があった場所です）
3. 種別 非公開（Private） の旧アプリを作成、または既存のものを開く
4. スコープ タブで crm.objects.contacts.read と crm.objects.contacts.write を選択
5. 認証（Auth） タブを開き、トークンを表示 をクリックしてコピー

​

Jinba Flowへの設定

1. Jinba Flowのワークスペース設定を開く
2. シークレット セクションに移動
3. シークレットを追加 をクリックし、タイプに HUBSPOT_ACCESS_TOKEN を選択
4. 名前を入力し、access_token にトークンを貼り付ける
5. 保存 をクリック

保存したシークレットは、HubSpotステップの Access Token ドロップダウンに表示されます。

​

必要なスコープ

スコープ	必要なツール
crm.objects.contacts.read	HUBSPOT_GET_CONTACT、および HUBSPOT_UPSERT_CONTACT の検索処理
crm.objects.contacts.write	HUBSPOT_UPSERT_CONTACT

ステップが HTTP 401 や HTTP 403 で失敗する場合、トークンが誤っているのではなく、これらのスコープが不足していることがほとんどです。

​

関連ドキュメント

• HubSpotツール
• HubSpot: 旧アプリ（非公開アプリ）
• HubSpot: サービスキー