# Pipedriveにリードを作成する

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

**リードを作成** アクションは、Pipedriveにリードと連絡先を作成します。このアクションは内部的に [add a lead](https://developers.pipedrive.com/docs/api/v1/Leads#addLead) APIエンドポイントを呼び出します。

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

## Formspree.jsonの設定

| キー | 型 | 説明 |
| --- | --- | --- |
| `app` |  String | `pipedrive` でなければなりません  |
| `apiKey` |  String | Pipedrive APIキー（[こちら](https://app.pipedrive.com/settings/personal/api) で確認可能。$ 環境変数参照である必要があります。必須） |
| `type` |  String | `createLead` でなければなりません |
| `overwriteContact` |  Boolean | 省略可能。true の場合、連絡先のメールアドレスまたは名前がPipedriveに既に存在する場合に連絡先情報を上書きします。デフォルトは false。 |
| `variableLeadValue` |  Boolean | 省略可能。true の場合、リードの値はフォームから送信された **value** フィールドで設定されます。デフォルトは false。 |
| `value` |  Numeric | 省略可能。リードの値。`variableLeadValue` が false の場合にのみリードに影響します。 |
| `currency` |  String | 省略可能。リード作成に使用する通貨コード。[利用可能な通貨コード](https://support.pipedrive.com/en/article/how-can-i-create-a-custom-currency) のいずれかでなければなりません。デフォルトはPipedriveアカウントのデフォルト通貨。 |

**例**

```javascript
{
  "forms": {
    "salesForm": {
      "name": "Sales Form",
      "actions": [
        {
          "app": "pipedrive",
          "type": "createLead",
          "apiKey": "$apiKey",
          "overwriteContact": true
          "variableLeadValue": false,
          "value": 100,
          "currency": "EUR"
        }
      ]
    }
  }
}
```

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

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

| フィールド | バリデーションルール |
| --- | --- |
| `email` | 必須 |
| `email` | 型は `email` |
| `name` または `fname` または `lname` | 必須 |