# Leads und Kontakte in HubSpot mit der Formspree CLI erstellen

> Formspree Docs · Die CLI verwenden · 14. Juli 2023

Das Hinzufügen der **hubspot**-Aktion in der Datei `formspree.json` hat denselben Effekt wie das Hinzufügen des HubSpot-Plugins im Formspree-Dashboard. Im [Hilfeartikel zum HubSpot-Plugin](/articles/plugins/use-hubspot-to-create-leads-and-contacts/) erfährst du mehr über **leadStatus,** **lifeCycleStage** und weitere Informationen.

## Eine Private App erstellen

HubSpot hat den Konto-API-Key abgekündigt. Stattdessen solltest du nun eine Private App erstellen und bestimmte Scopes für das Access-Token auswählen. Weitere Informationen [findest du hier.](https://developers.hubspot.com/docs/api/private-apps)

-   Klicke in deinem HubSpot-Konto auf das **Einstellungssymbol** in der Hauptnavigationsleiste.
-   Navigiere im linken Seitenleistenmenü zu **Integrations**\>**Private Apps**.
-   Klicke auf **Create private app**.
-   Konfiguriere deine App-Details
-   Klicke auf den Tab **scopes** und aktiviere 
    -   `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)
-   Überprüfe im Dialogfeld die Informationen zum Access-Token deiner App und klicke dann auf **Continue creating**.

Um mit API-Aufrufen zu beginnen, navigiere zur Detailseite deiner App.

Klicke auf der Karte _Access_ _token_ auf **Show token**, um dein Access-Token anzuzeigen. Klicke auf **Copy**, um das Token in deine Zwischenablage zu kopieren, und füge es als accessToken-Attribut in deine Formspree-CLI-Deployment-Datei ein.

## Formspree.json-Konfiguration

| Schlüssel | Typ | Beschreibung |
| --- | --- | --- |
| `app` |  String | Muss `hubspot` sein |
| `type` |  String | Muss `createContact` sein |
| `apiKey` |  String | Dein API-Schlüssel (muss eine $-Umgebungsvariablen-Referenz sein, erforderlich) (veraltet) |
| `accessToken` |  String | Das Access-Token deiner Private App (muss eine $-Umgebungsvariablen-Referenz sein, erforderlich)  |
| `leadStatus` |  String | Optionales Feld. Muss einer von `NEW`, `OPEN`, `IN_PROGRESS`, `OPEN_DEAL`, `UNQUALIFIED`, `ATTEMPTED_TO_CONTACT`, `CONNECTED` oder `BAD_TIMING` sein. Standard ist `NEW`. |
| `lifeCycleStage` |  String | Optionales Feld. Muss einer von `subscriber`, `lead`, `marketingqualifiedlead`, `salesqualifiedlead`, `opportunity`, `customer` oder `other` sein. Standard ist leer. |
| `overwriteContact` |  Boolean | Optionales Feld. Wenn true, werden die Kontaktinformationen überschrieben, falls die Kontakt-E-Mail bereits in HubSpot existiert. Standard ist false |

**Beispiel**

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

## Validierungsregeln

Die Aktion **create support ticket** fügt implizit die folgenden Validierungsregeln hinzu:

| Feld | Validierungsregel |
| --- | --- |
| `email` | Erforderlich |
| `email` | Typ ist `email` |