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

# Configurer un abonnement au webhook (BÊTA)

> Découvrez comment définir un abonnement webhook sur la dernière version de la plateforme de développement (BÊTA).

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

    `}
</style>

Pour définir un ensemble d'abonnements webhook pour une application sur la nouvelle plateforme de développement, incluez un répertoire `webhooks` dans le projet ainsi qu'un fichier de configuration `*-hsmeta.json`.

## Structure du répertoire

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

## Configuration du Webhook

Vous trouverez ci-dessous les options de configuration disponibles pour le fichier `*-hsmeta.json`.

```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">
  Les champs marqués par sont <span style={{ color: 'red' }}>\*</span> obligatoires.
</p>

| Champ                                                | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uid`<span style={{color:"red"}}>\*</span>           | Chaîne  | un identifiant unique interne pour le composant du webhook.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `type`<span style={{color:"red"}}>\*</span>          | Chaîne  | le type de composant, qui devrait être `webhooks` dans ce cas.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `settings`<span style={{color:"red"}}>\*</span>      | Objet   | un objet qui spécifie deux champs : `targetUrl`, qui est l'URL publique que HubSpot peut appeler l'endroit où les charges utiles de l'événement seront livrées, et `maxConcurrentRequests`, qui est le seuil supérieur des demandes HTTP que HubSpot effectuera dans une période donnée.                                                                                                                                                                                                                       |
| `subscriptions`<span style={{color:"red"}}>\*</span> | Objet   | un objet qui spécifie les types d'abonnements auxquels votre application s'abonnera.                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `crmObjects`                                         | Tableau | <p>un tableau contenant des définitions d'abonnement aux événements. Il s'agit du tableau standard à inclure, qui doit être utilisé pour tous les événements dans le [nouveau format](/docs/apps/legacy-apps/public-apps/create-generic-webhook-subscriptions) (`object.*`).</p> <p>[Les types d'abonnement de webhook classiques](/docs/api-reference/webhooks-webhooks-v3/guide#webhook-subscriptions) doivent plutôt être inclus dans les tableaux `legacyCrmObjects` et `hubEvents`, en fonction de l'événement.</p> |
| `legacyCrmObjects`                                   | Tableau | un tableau contenant les [types d'abonnements classiques](/docs/api-reference/webhooks-webhooks-v3/guide#webhook-subscriptions), tels que `contact.creation` et `deal.deletion`.                                                                                                                                                                                                                                                                                                                                    |
| `hubEvents`                                          | Tableau | un tableau contenant les types `contact.privacyDeletion` d'abonnements classiques et `conversation.*`                                                                                                                                                                                                                                                                                                                                                                                                          |

Pour chaque objet `subscription`, les champs suivants peuvent être spécifiés, en fonction du type de définition d'abonnement auquel vous êtes abonné (c'est-à-dire `crmObjects`, `legacyCrmObjects` ou `hubEvents`) ou selon que vous êtes abonné à une modification de propriété spécifique (par exemple, `contact.propertyChange`).

| Champ              | Type    | Description                                                                                                                  |
| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `subscriptionType` | Chaîne  | le type d'événement auquel l'abonné est abonné.                                                                              |
| `objectType`       | Chaîne  | pour les abonnements spécifiés dans le tableau `crmObjects`, cela spécifie l'objet CRM auquel votre application est abonnée. |
| `propertyName`     | Chaîne  | pour les abonnements de modification de propriété, cela spécifie la propriété qui déclenchera l'événement webhook.           |
| `active`           | Booléen | si des événements webhook seront déclenchés pour cet abonnement.                                                             |