> ## 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. # Batch create event subscriptions > Créer en lot des abonnements aux événements pour l'application spécifiée. > **Supported products** ## OpenAPI ````yaml specs/legacy/v3/webhooks-webhooks-v3.json POST /webhooks/v3/{appId}/subscriptions/batch/update openapi: 3.0.1 info: title: Webhooks Webhooks description: >- Provides a way for apps to subscribe to certain change events in HubSpot. Once configured, apps will receive event payloads containing details about the changes at a specified target URL. There can only be one target URL for receiving event notifications per app. version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-related-documentation: - name: Webhooks Guide url: https://developers.hubspot.com/docs/guides/api/webhooks/overview servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch paths: /webhooks/v3/{appId}/subscriptions/batch/update: post: tags: - Batch summary: Créer en lot des abonnements à des événements description: >- Créer en lot des abonnements aux événements pour l'application spécifiée. operationId: post-/webhooks/v3/{appId}/subscriptions/batch/update_updateBatch parameters: - name: appId in: path description: L'ID de l'application cible. required: true style: simple explode: false schema: type: integer format: int32 requestBody: description: Updated details for the specified subscriptions. content: application/json: schema: $ref: '#/components/schemas/BatchInputSubscriptionBatchUpdateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseSubscriptionResponse' example: completedAt: '2020-04-17T02:19:26.283Z' results: - active: true createdAt: '2019-06-06T16:56:16.652Z' eventType: contact.propertyChange id: '1234' propertyName: firstname updatedAt: '2019-08-06T16:56:16.652Z' - active: false createdAt: '2019-06-06T16:56:16.652Z' eventType: contact.create id: '4567' updatedAt: '2019-08-06T16:56:16.652Z' startedAt: '2020-04-17T02:19:26.256Z' status: COMPLETE '207': description: multiple statuses content: application/json: schema: $ref: >- #/components/schemas/BatchResponseSubscriptionResponseWithErrors example: completedAt: '2020-04-17T02:19:26.283Z' errors: - category: SUBSCRIPTION_ID_NOT_FOUND context: subscriptionIds: - '4567' message: >- Failed to find subscriptions by id `4567`. Try again using a different subscriptionId. status: error subCategory: SubscriptionErrors.SUBSCRIPTION_IDS_NOT_FOUND numErrors: 1 results: - active: true createdAt: '2019-06-06T16:56:16.652Z' eventType: contact.propertyChange id: '1234' propertyName: firstname updatedAt: '2019-08-06T16:56:16.652Z' startedAt: '2020-04-17T02:19:26.256Z' status: COMPLETE default: $ref: '#/components/responses/Error' description: '' security: - developer_hapikey: [] components: schemas: BatchInputSubscriptionBatchUpdateRequest: required: - inputs type: object properties: inputs: type: array description: >- Un tableau d'objets SubscriptionBatchUpdateRequest, chacun représentant les paramètres mis à jour pour un abonnement de webhook spécifique dans l'opération par lot. items: $ref: '#/components/schemas/SubscriptionBatchUpdateRequest' BatchResponseSubscriptionResponse: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: L'horodatage de la fin de l'opération par lots, au format ISO 8601. format: date-time links: type: object additionalProperties: type: string description: Un objet contenant les URL des ressources ou opérations associées. requestedAt: type: string description: "L'horodatage de la demande d'opération par lot, au format ISO\_8601." format: date-time results: type: array description: >- Un tableau contenant les abonnements de webhook traités avec succès à partir de l'opération par lot. items: $ref: '#/components/schemas/SubscriptionResponse' startedAt: type: string description: "L'horodatage du début du traitement de l'opération par lot, au format ISO\_8601." format: date-time status: type: string description: "Le statut de l'opération par lot. Les valeurs acceptées sont «\_PENDING\_​», «\_PROCESSING\_», «\_CANCELED\_» ou «\_COMPLETE\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING BatchResponseSubscriptionResponseWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- L'horodatage auquel l'opération par lot a été effectuée, au format ISO 8601 (par exemple, 2020-02-29T12:30:00Z). format: date-time errors: type: array description: >- Un tableau contenant les détails des erreurs pour tout abonnement qui n'a pas pu être traité pendant l'opération par lot. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: Un objet contenant les URL des ressources ou opérations associées. numErrors: type: integer description: Le nombre d'erreurs survenues pendant l'opération par lot. format: int32 requestedAt: type: string description: >- L'horodatage de la demande d'opération par lot, au format ISO 8601 (par exemple, 2020-02-29T12:30:00Z). format: date-time results: type: array description: >- Un tableau contenant les abonnements de webhook traités avec succès à partir de l'opération par lot. items: $ref: '#/components/schemas/SubscriptionResponse' startedAt: type: string description: >- L'horodatage du début du traitement de l'opération par lot, au format ISO 8601 (par exemple, 2020-02-29T12:30:00Z). format: date-time status: type: string description: >- Le statut de l'opération par lot. Les valeurs acceptées sont EN ATTENTE, EN COURS, ANNULÉE ou TERMINÉE. enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: >- Response for batch operations on webhook subscriptions, containing successful results and any errors that occurred. example: completedAt: '2020-04-17T02:19:26.283Z' errors: - category: SUBSCRIPTION_ID_NOT_FOUND message: Failed to find subscriptions by id `4567`. status: error numErrors: 1 results: - active: true createdAt: '2019-06-06T16:56:16.652Z' eventType: contact.propertyChange id: '1234' propertyName: firstname updatedAt: '2019-08-06T16:56:16.652Z' startedAt: '2020-04-17T02:19:26.256Z' status: COMPLETE SubscriptionBatchUpdateRequest: required: - active - id type: object properties: active: type: boolean description: "Permet d'activer ou de suspendre l'abonnement aux webhooks. Si la valeur est «\_true\_», l'abonnement enverra des notifications de webhook. Si la valeur est «\_false\_», l'abonnement sera suspendu et n'enverra pas de notification. Il s'agit d'un booléen." id: type: integer description: >- L'ID de l'abonnement au webhook à mettre à jour. Il s'agit d'un entier. format: int32 description: Updated settings for a webhook subscription in a batch update operation. example: active: true id: 12 SubscriptionResponse: required: - active - createdAt - eventType - id type: object properties: active: type: boolean description: "Indique si l'abonnement est actif ou suspendu. Si la valeur est «\_true\_», l'abonnement enverra des notifications de webhook. Si la valeur est «\_false\_», l'abonnement sera suspendu et n'enverra pas de notifications." createdAt: type: string description: >- L'horodatage de la création de l'abonnement au webhook, au format ISO 8601 (par exemple, 2020-02-29T12:30:00Z). format: date-time eventType: type: string description: >- Le type d'évènement à écouter. Les valeurs acceptées incluent contact.creation, contact.deletion, contact.propertyChange et des types d'évènements similaires pour d'autres objets CRM et objets personnalisés. enum: - company.associationChange - company.creation - company.deletion - company.merge - company.propertyChange - company.restore - contact.associationChange - contact.creation - contact.deletion - contact.merge - contact.privacyDeletion - contact.propertyChange - contact.restore - conversation.creation - conversation.deletion - conversation.newMessage - conversation.privacyDeletion - conversation.propertyChange - deal.associationChange - deal.creation - deal.deletion - deal.merge - deal.propertyChange - deal.restore - event.completed - line_item.associationChange - line_item.creation - line_item.deletion - line_item.merge - line_item.propertyChange - line_item.restore - object.associationChange - object.creation - object.deletion - object.merge - object.propertyChange - object.restore - product.creation - product.deletion - product.merge - product.propertyChange - product.restore - ticket.associationChange - ticket.creation - ticket.deletion - ticket.merge - ticket.propertyChange - ticket.restore eventTypeName: type: string description: >- Le nom de l'évènement à écouter. Il est utilisé avec des objets personnalisés pour spécifier des types d'évènements personnalisés au-delà des valeurs d'énumération eventType standard. id: type: string description: L'ID unique de l'abonnement au webhook. objectTypeId: type: string description: >- L'ID du type d'objet pour l'abonnement. Il peut s'agir d'un objet CRM standard (par exemple, « contact », « entreprise », « transaction ») ou d'un ID d'objet personnalisé pour les abonnements à des objets personnalisés. propertyName: type: string description: >- Le nom interne de la propriété à surveiller pour les changements. S'applique uniquement lorsque eventType est propertyChange. updatedAt: type: string description: >- L'horodatage de la dernière mise à jour de l'abonnement au webhook, au format ISO 8601 (par exemple, 2020-02-29T12:30:00Z). format: date-time description: Complete details for an event subscription. StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: Une chaîne désignant la catégorie de l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant le contexte de l'erreur, avec des propriétés supplémentaires sous forme de tableaux de chaînes de caractères. errors: type: array description: >- Un tableau d'objets ErrorDetail, chacun fournissant des informations supplémentaires sur les erreurs individuelles. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Une chaîne représentant l'identifiant unique de l'erreur. links: type: object additionalProperties: type: string description: >- Un objet associant des noms de liens à des URI connexes, qui contiennent de la documentation sur l'erreur ou des étapes de remédiation recommandées. message: type: string description: Message lisible par l'être humain décrivant l'erreur. status: type: string description: Une chaîne indiquant le statut de l'erreur. subCategory: type: object properties: {} description: >- Un objet fournissant une catégorisation supplémentaire et plus spécifique de l'erreur. description: >- Représente une réponse aux erreurs standard dans l'API HubSpot, fournissant des informations détaillées sur une erreur survenue lors d'une requête API. Error: required: - category - correlationId - message type: object properties: category: type: string description: >- La catégorie d'erreur, représentée sous forme de chaine de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant le contexte concernant la condition d'erreur. Cela inclut des propriétés supplémentaires, chacune étant un tableau de chaînes. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande, formaté en UUID. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau fournissant des informations supplémentaires sur l'erreur. Chaque élément du tableau est un objet ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées contenant de la documentation sur l'erreur ou les étapes de correction recommandées. Il s'agit d'un objet avec des propriétés de chaîne. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur et les mesures correctives à prendre, le cas échéant. Il s'agit d'une chaîne. example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui fournit des informations plus détaillées sur l'erreur. Il s'agit d'une chaîne. 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 d'état associé au détail de l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, fourni sous la forme d'un objet avec des propriétés supplémentaires. example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les étapes de remédiation appropriées, 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' securitySchemes: developer_hapikey: type: apiKey name: hapikey in: query ````