> ## 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. # Create or update a subscription > Créez ou mettez à jour un abonnement existant en spécifiant les champs et les formes des événements que vous devez écouter. La documentation complète sur les types d'abonnement potentiels se trouve sur la page de documentation de présentation. > **Supported products** ## OpenAPI ````yaml specs/2026-03/webhooks-webhooks-v2026-03.json POST /webhooks-journal/subscriptions/2026-03 openapi: 3.0.1 info: title: Webhooks Webhooks description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch paths: /webhooks-journal/subscriptions/2026-03: post: tags: - Basic summary: Insérer un abonnement description: >- Créez ou mettez à jour un abonnement existant en spécifiant les champs et les formes des événements que vous devez écouter. La documentation complète sur les types d'abonnement potentiels se trouve sur la page de documentation de présentation. operationId: >- post-/webhooks-journal/subscriptions/2026-03_/webhooks-journal/subscriptions/2026-03 parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/SubscriptionUpsertRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/SubscriptionResponse_1' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: SubscriptionUpsertRequest: properties: {} oneOf: - $ref: '#/components/schemas/ObjectSubscriptionUpsertRequest' - $ref: '#/components/schemas/AssociationSubscriptionUpsertRequest' - $ref: '#/components/schemas/AppLifecycleEventSubscriptionUpsertRequest' - $ref: '#/components/schemas/ListMembershipSubscriptionUpsertRequest' - $ref: '#/components/schemas/GdprPrivacyDeletionSubscriptionUpsertRequest' SubscriptionResponse_1: required: - actions - appId - createdAt - id - objectTypeId - subscriptionType - updatedAt type: object properties: actionOverrides: type: object additionalProperties: $ref: '#/components/schemas/ActionOverrideRequest' description: >- Un objet contenant des remplacements d'action, où chaque clé est une action et la valeur est un objet ActionOverrideRequest. actions: type: array description: "Une liste d'actions qui déclenchent l'abonnement. Les valeurs possibles incluent «\_CREATE\_», «\_UPDATE\_», «\_DELETE\_», «\_MERGE\_», «\_RESTORE\_», «\_ASSOCIATION_ADDED\_», «\_ASSOCIATION_REMOVED\_», «\_SNAPSHOT\_», «\_APP_INSTALL\_», «\_APP_UNINSTALL\_», «\_ADDED_TO_LIST\_», «\_REMOVED_FROM_LIST\_» et «\_RGPD_DELETE\_»." items: type: string enum: - CREATE - UPDATE - DELETE - MERGE - RESTORE - ASSOCIATION_ADDED - ASSOCIATION_REMOVED - SNAPSHOT - APP_INSTALL - APP_UNINSTALL - ADDED_TO_LIST - REMOVED_FROM_LIST - GDPR_DELETE appId: type: integer description: >- L'identifiant unique de l'application associée à l'abonnement. Il s'agit d'un entier formaté en int64. format: int64 associatedObjectTypeIds: type: array description: >- Une liste d'ID de types d'objets associés. Chaque ID est une chaîne de caractères. items: type: string createdAt: type: string description: La date et l'heure de création de l'abonnement, au format ISO 8601. format: date-time createdBy: type: integer description: >- L'ID de l'utilisateur qui a créé l'abonnement. Il s'agit d'un entier formaté en int64. format: int64 deletedAt: type: string description: >- La date et l'heure de suppression de l'abonnement, au format ISO 8601, le cas échéant. format: date-time id: type: integer description: >- L'identifiant unique de l'abonnement. Il s'agit d'un entier formaté en int64. format: int64 listIds: type: array description: >- Une liste d'ID de listes associées à l'abonnement. Chaque ID est un entier au format int64. items: type: integer format: int64 objectIds: type: array description: >- Une liste d'ID d'objets associés à l'abonnement. Chaque ID est un entier formaté en int64. items: type: integer format: int64 objectTypeId: type: string description: >- L'identifiant du type d'objet associé à l'abonnement. Il s'agit d'une chaîne de caractères. portalId: type: integer description: >- L'identifiant unique du portail associé à l'abonnement. Il s'agit d'un entier formaté en int64. format: int64 properties: type: array description: >- Une liste de noms de propriétés associés à l'abonnement. Chaque propriété est une chaîne de caractères. items: type: string subscriptionType: type: string description: "Le type d'abonnement, qui peut être l'un des suivants\_: «\_OBJECT\_», «\_ASSOCIATION\_», «\_EVENT\_», «\_APP_LIFECYCLE_EVENT\_», «\_LIST_MEMBERSHIP\_» ou «\_RGPD_PRIVACY_DELETION\_»." enum: - APP_LIFECYCLE_EVENT - ASSOCIATION - EVENT - GDPR_PRIVACY_DELETION - LIST_MEMBERSHIP - OBJECT updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de l'abonnement, au format ISO 8601. format: date-time ObjectSubscriptionUpsertRequest: required: - actions - objectIds - objectTypeId - portalId - properties - subscriptionType type: object properties: actions: type: array description: "Un tableau de chaînes de caractères spécifiant les actions qui déclenchent l'abonnement. Les actions valides incluent «\_CREATE\_», «\_UPDATE\_», «\_DELETE\_», «\_MERGE\_», «\_RESTORE\_»." items: type: string enum: - CREATE - UPDATE - DELETE - MERGE - RESTORE - ASSOCIATION_ADDED - ASSOCIATION_REMOVED - SNAPSHOT - APP_INSTALL - APP_UNINSTALL - ADDED_TO_LIST - REMOVED_FROM_LIST - GDPR_DELETE objectIds: type: array description: >- Un tableau d'entiers représentant les ID des objets impliqués dans l'abonnement. Un tableau vide signifie s'abonner à tous les objectIds. items: type: integer format: int64 objectTypeId: type: string description: "Une chaîne de caractères qui identifie le type d'objet pour lequel l'abonnement est créé ou mis à jour. Par exemple, «\_0-1\_» pour les contacts." portalId: type: integer description: Un entier représentant l'ID du portail associé à l'abonnement. format: int64 properties: type: array description: >- Un tableau de chaînes de caractères listant les propriétés des objets pertinentes pour l'abonnement. Un tableau vide signifie que toutes les propriétés sont écoutées. items: type: string subscriptionType: type: string description: "Une chaîne indiquant le type d'abonnement. La valeur par défaut et la seule valeur valide est «\_OBJECT\_»." default: OBJECT enum: - OBJECT x-hubspot-sub-type-impl: true AssociationSubscriptionUpsertRequest: required: - actions - associatedObjectTypeIds - objectIds - objectTypeId - portalId - subscriptionType type: object properties: actions: type: array description: "Un tableau de chaînes spécifiant les actions qui déclenchent l'abonnement. Les actions valides incluent «\_ASSOCIATION_ADDED\_» et «\_ASSOCIATION_REMOVED\_»." items: type: string enum: - CREATE - UPDATE - DELETE - MERGE - RESTORE - ASSOCIATION_ADDED - ASSOCIATION_REMOVED - SNAPSHOT - APP_INSTALL - APP_UNINSTALL - ADDED_TO_LIST - REMOVED_FROM_LIST - GDPR_DELETE associatedObjectTypeIds: type: array description: >- Un tableau de chaînes de caractères représentant les identifiants de type des objets associés impliqués dans l'abonnement. S'il est présent, les événements ne se déclencheront que si l'objectTypeId de l'objet CIBLE dans l'association est inclus dans ce tableau. items: type: string objectIds: type: array description: >- Un tableau d'entiers représentant les identifiants uniques des objets impliqués dans l'abonnement. items: type: integer format: int64 objectTypeId: type: string description: "Une chaîne représentant l'identifiant de type de l'objet impliqué dans l'abonnement. Par exemple, «\_0-1\_» pour les contacts. Cela correspond au côté EXPÉDITION de l'association. Un objectTypeId de «\_0-1\_» correspondrait à un changement d'association CONTACT_TO_COMPANY. " portalId: type: integer description: Un entier représentant l'identifiant unique du portail HubSpot. format: int64 subscriptionType: type: string description: "Une chaîne indiquant le type d'abonnement, qui est «\_ASSOCIATION\_» par défaut." default: ASSOCIATION enum: - ASSOCIATION x-hubspot-sub-type-impl: true AppLifecycleEventSubscriptionUpsertRequest: required: - eventTypeId - properties - subscriptionType type: object properties: eventTypeId: type: string description: "Une chaîne de caractères représentant l'identifiant unique du type d'événement auquel l'abonnement se rapporte. Cette valeur correspond à une classification interne des événements chez HubSpot.\n\n4-1909196\_: Événement d'installation d'application\n4-1916193\_: Événement de désinstallation d'application" properties: type: array description: >- Un tableau de chaînes spécifiant les propriétés de l'événement associé à l'abonnement. items: type: string subscriptionType: type: string description: "Une chaîne indiquant le type d'abonnement, qui est «\_APP_LIFECYCLE_EVENT\_» par défaut." default: APP_LIFECYCLE_EVENT enum: - APP_LIFECYCLE_EVENT x-hubspot-sub-type-impl: true ListMembershipSubscriptionUpsertRequest: required: - actions - listIds - objectIds - portalId - subscriptionType type: object properties: actions: type: array description: "Un tableau de chaînes de caractères spécifiant les actions qui déclenchent l'abonnement. Les actions valides incluent «\_ADDED_TO_LIST\_» et «\_REMOVED_FROM_LIST\_»" items: type: string enum: - CREATE - UPDATE - DELETE - MERGE - RESTORE - ASSOCIATION_ADDED - ASSOCIATION_REMOVED - SNAPSHOT - APP_INSTALL - APP_UNINSTALL - ADDED_TO_LIST - REMOVED_FROM_LIST - GDPR_DELETE listIds: type: array description: >- Un tableau d’entiers représentant les identifiants des listes impliquées dans l’abonnement. Un tableau vide signifie que toutes les listes sont écoutées. items: type: integer format: int64 objectIds: type: array description: >- Un tableau d'entiers représentant les identifiants des objets associés à l'abonnement. Un tableau vide signifie tous les objectsIds sont écoutés. items: type: integer format: int64 portalId: type: integer description: Un entier représentant l'ID du portail où l'abonnement est géré. format: int64 subscriptionType: type: string description: "Une chaîne indiquant le type d'abonnement. La valeur par défaut et la seule valeur valide est «\_LIST_MEMBERSHIP\_»." default: LIST_MEMBERSHIP enum: - LIST_MEMBERSHIP x-hubspot-sub-type-impl: true GdprPrivacyDeletionSubscriptionUpsertRequest: required: - actions - objectTypeId - portalId - subscriptionType type: object properties: actions: type: array description: "Un tableau de chaînes spécifiant les actions qui déclenchent l'abonnement. L'action valide est «\_RGPD_DELETE\_». " items: type: string enum: - CREATE - UPDATE - DELETE - MERGE - RESTORE - ASSOCIATION_ADDED - ASSOCIATION_REMOVED - SNAPSHOT - APP_INSTALL - APP_UNINSTALL - ADDED_TO_LIST - REMOVED_FROM_LIST - GDPR_DELETE objectTypeId: type: string description: >- Une chaîne représentant l'identifiant unique du type d'objet associé à l'abonnement. portalId: type: integer description: >- Un entier représentant l'identifiant unique du portail HubSpot écouté pour les changements. format: int64 subscriptionType: type: string description: >- Une chaîne de caractères indiquant le type d'abonnement. RGPD_PRIVACY_DELETION est la seule option valide pour GdprPrivacyDeletionSubscriptionUpsertRequest. default: GDPR_PRIVACY_DELETION enum: - GDPR_PRIVACY_DELETION x-hubspot-sub-type-impl: true ActionOverrideRequest: type: object properties: associatedObjectTypeIds: type: array description: >- Un tableau de chaînes de caractères, chacune représentant un ID de type d'objet associé pertinent pour la substitution d'action. items: type: string listIds: type: array description: >- Un tableau d'entiers représentant les ID de liste associés à la substitution d'action. Les entiers sont au format int64. items: type: integer format: int64 objectIds: type: array description: >- Un tableau d'entiers, chacun représentant un ID d'objet pour lequel la substitution d'action est applicable. Les entiers sont au format int64. items: type: integer format: int64 properties: type: array description: >- Un tableau de chaînes de caractères représentant les propriétés à remplacer dans l'action. Chaque chaîne correspond à un nom de propriété. items: type: string Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été détectée. Il s'agit d'une propriété de type chaîne de caractères. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````