> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ein Webhook-Abonnement konfigurieren (BETA)

> Erfahren Sie, wie Sie ein Webhook-Abonnement auf der neuesten Version der Entwicklerplattform (BETA) definieren.

<style>
  {`
    .table-key, .table-key div, .table-key p {
      margin: 0;
      font-size: 14px;
    }
    code {
      text-wrap:nowrap!important;
    }

    `}
</style>

Um eine Anzahl von Webhook-Abonnements für eine App auf der neuen Entwicklerplattform zu definieren, fügen Sie dem Projekt ein `webhooks`-Verzeichnis zusammen mit einer `*-hsmeta.json`-Konfigurationsdatei bei.

## Verzeichnisstruktur

```shell theme={null}
├──src
│   ├── app/
│   │   └── app-hsmeta.json
│   │   └── ...
│   │   └── webhooks/
│   │     └── webhooks-hsmeta.json
└──
```

## Webhook-Berichtskonfiguration

Nachfolgend finden Sie die verfügbaren Konfigurationsoptionen für die `*-hsmeta.json`-Datei.

```json theme={null}
{
  "uid": "webhooks",
  "type": "webhooks",
  "config": {
    "settings": {
      "targetUrl": "https://example.com/webhook",
      "maxConcurrentRequests": 10
    },
    "subscriptions": {
      "crmObjects": [
        {
          "subscriptionType": "object.creation",
          "objectType": "contact",
          "active": true
        }
      ],
      "legacyCrmObjects": [
        {
          "subscriptionType": "contact.propertyChange",
          "propertyName": "lastname",
          "active": true
        },
        {
          "subscriptionType": "contact.deletion",
          "active": true
        }
      ],
      "hubEvents": [
        {
          "subscriptionType": "contact.privacyDeletion",
          "active": true
        }
      ]
    }
  }
}
```

<p className="table-key">
  Mit <span style={{ color: 'red' }}>\*</span> markierte Felder sind Pflichtfelder.
</p>

| Feld                                                 | Typ          | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uid`<span style={{color:"red"}}>\*</span>           | Zeichenfolge | Eine interne eindeutige ID für die Webhook-Komponente.                                                                                                                                                                                                                                                                                                                                                                                                     |
| `type`<span style={{color:"red"}}>\*</span>          | Zeichenfolge | Der Typ der Komponente, die in diesem Fall `webhooks` sein sollte.                                                                                                                                                                                                                                                                                                                                                                                         |
| `settings`<span style={{color:"red"}}>\*</span>      | Objekt       | Ein Objekt, das zwei Felder angibt: `targetUrl` ist die öffentlich verfügbare URL für HubSpot-Aufrufe, an die Event-Payloads geliefert werden, und `maxConcurrentRequests` stellt den oberen Schwellenwert von HTTP-Anfragen dar, die HubSpot in einem bestimmten Zeitraum vornimmt.                                                                                                                                                                       |
| `subscriptions`<span style={{color:"red"}}>\*</span> | Objekt       | Ein Objekt, das die Abonnementtypen angibt, die Ihre App abonnieren wird.                                                                                                                                                                                                                                                                                                                                                                                  |
| `crmObjects`                                         | Array        | <p>Ein Array mit Definitionen für Event-Abonnements. Dies ist das aufzunehmende Standard-Array, das für alle Events im [neuen Format](/apps/legacy-apps/public-apps/create-generic-webhook-subscriptions) (`object.*`) verwendet werden sollte.</p> <p>[Klassische Webhook-Abonnementtypen](/api-reference/webhooks-webhooks-v3/guide#webhook-subscriptions) sollten aber je nach Event in `legacyCrmObjects`- und `hubEvents` -Arrays enthalten sein.</p> |
| `legacyCrmObjects`                                   | Array        | Ein Arraymit [klassischen Abonnementtypen](/api-reference/webhooks-webhooks-v3/guide#webhook-subscriptions) wie `contact.creation` und `deal.deletion`.                                                                                                                                                                                                                                                                                                    |
| `hubEvents`                                          | Array        | Ein Array mit den klassischen Abonnementtypen `contact.privacyDeletion` und `conversation.*`                                                                                                                                                                                                                                                                                                                                                               |

Für jedes `subscription` Objekt können die folgenden Felder angegeben werden, je nachdem, welcher Abonnementdefinitionstyp abonniert wird (d. h. `crmObjects`, `legacyCrmObjects`bzw. `hubEvents`) oder abhängig davon, ob Sie eine bestimmte Eigenschaftsänderung abonnieren (z  B `contact.propertyChange`).

| Feld               | Typ             | Beschreibung                                                                                                                |
| ------------------ | --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `subscriptionType` | Zeichenfolge    | Der Typ des abonnierten Events.                                                                                             |
| `objectType`       | Zeichenfolge    | Für Abonnements, die innerhalb des `crmObjects`-Arrays angegeben sind, gibt dies das CRM-Objekt an, das Ihre App abonniert. |
| `propertyName`     | Zeichenfolge    | Bei Abonnements von Eigenschaftenänderungen gibt dies an, durch welche Eigenschaft das Webhook-Event ausgelöst wird.        |
| `active`           | Boolescher Wert | Gibt an, ob Webhook-Events für dieses Abonnement ausgelöst werden.                                                          |