# Formspree CLIを使ってHubSpotにリードと連絡先を作成する

> Formspree Docs · CLIの使用方法 · 2023年7月14日

`formspree.json` ファイルに **hubspot** アクションを追加することは、FormspreeダッシュボードでHubspotプラグインを追加するのと同じ効果があります。**leadStatus**、**lifeCycleStage** などの詳細については、[Hubspotプラグインのヘルプ記事](/articles/plugins/use-hubspot-to-create-leads-and-contacts/) をご覧ください。

## プライベートアプリの作成

HubspotはアカウントAPIキーを廃止しました。現在は、代わりにプライベートアプリを作成し、アクセストークンに特定のスコープを選択する必要があります。詳細については [こちらをご確認ください。](https://developers.hubspot.com/docs/api/private-apps)

-   HubSpotアカウントで、メインナビゲーションバーの **設定アイコン** をクリックします。
-   左サイドバーメニューで、**統合** \> **プライベートアプリ** に移動します。
-   **プライベートアプリを作成** をクリックします。
-   アプリの詳細を設定します。
-   **スコープ** タブをクリックして以下を確認します：
    -   `crm.objects.contacts.read` (CRM->Contacts->Read)
    -   `crm.objects.contacts.write` (CRM->Contacts->Read)
    -   `crm.objects.companies.read` (CRM->Companies->Read)
    -   `crm.objects.companies.write` (CRM->Companies->Write)
-   ダイアログボックスでアプリのアクセストークンに関する情報を確認し、**作成を続ける** をクリックします。

APIコールを開始するには、アプリの詳細ページに移動します。

_アクセス_ _トークン_ カードで **トークンを表示** をクリックしてアクセストークンを確認します。**コピー** をクリックしてトークンをクリップボードにコピーし、Formspree CLIデプロイメントファイルの accessToken 属性に貼り付けます。

## Formspree.jsonの設定

| キー | 型 | 説明 |
| --- | --- | --- |
| `app` |  String | `hubspot` でなければなりません |
| `type` |  String | `createContact` でなければなりません |
| `apiKey` |  String | APIキー（$env変数参照である必要があります。必須）（非推奨） |
| `accessToken` |  String | プライベートアプリのアクセストークン（$env変数参照である必要があります。必須） |
| `leadStatus` |  String | 省略可能。`NEW`、`OPEN`、`IN_PROGRESS`、`OPEN_DEAL`、`UNQUALIFIED`、`ATTEMPTED_TO_CONTACT`、`CONNECTED`、または `BAD_TIMING` のいずれか。デフォルトは `NEW`。 |
| `lifeCycleStage` |  String | 省略可能。`subscriber`、`lead`、`marketingqualifiedlead`、`salesqualifiedlead`、`opportunity`、`customer`、または `other` のいずれか。デフォルトは空。 |
| `overwriteContact` |  Boolean | 省略可能。true の場合、連絡先のメールアドレスがHubspotに既に存在する場合に連絡先情報を上書きします。デフォルトは false。 |

**例**

```javascript
{
  "forms": {
    "registrationForm": {
      "name": "Registration Form",
      "actions": [
        {
          "app": "hubspot",
          "type": "createContact",
          "accessToken": "$accessToken",
          "leadStatus": "NEW",
          "lifeCycleStage": "lead",
          "overwriteContact": true
        }
      ]
    }
  }
}
```

## バリデーションルール

**サポートチケットを作成** アクションは、以下のバリデーションルールを暗黙的に追加します：

| フィールド | バリデーションルール |
| --- | --- |
| `email` | 必須 |
| `email` | 型は `email` |