> ## Documentation Index
> Fetch the complete documentation index at: https://carnot.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot認証情報

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

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

## 前提条件

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

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

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

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

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

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

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

### 方法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ツール](/ja/pages/tools/productivity/hubspot)
* [HubSpot: 旧アプリ（非公開アプリ）](https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview)
* [HubSpot: サービスキー](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys)