> ## 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 batch of deals by unique property values > Créez ou mettez à jour des fiches d'informations identifiées par une valeur de propriété unique spécifiée par le paramètre de requête « idProperty ». Le paramètre de requête « idProperty » fait référence à une propriété dont les valeurs sont uniques pour l'objet. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/crm-deals-v2026-03.json POST /crm/objects/2026-03/0-3/batch/upsert openapi: 3.0.1 info: title: Transactions 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 x-hubspot-api-use-case: >- Lorsqu'un représentant commercial commence à travailler avec un client potentiel, créez une fiche d'informations de transaction pour suivre le processus de négociation. Lorsque le client effectue ensuite son achat, vous pouvez actualiser la transaction à une phase fermée. x-hubspot-introduction: >- Utilisez l'API des transactions pour créer et gérer des fiches d'informations CRM qui représentent des transactions avec des contacts et/ou des entreprises. Les transactions progressent à travers les étapes du pipeline pour refléter si la transaction a été complétée, est active, ou a été perdue. servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch - name: Search paths: /crm/objects/2026-03/0-3/batch/upsert: post: tags: - Batch summary: >- Créer ou mettre à jour un lot de transactions par des valeurs de propriété uniques description: "Créez ou mettez à jour des fiches d'informations identifiées par une valeur de propriété unique spécifiée par le paramètre de requête «\_idProperty\_». Le paramètre de requête «\_idProperty\_» fait référence à une propriété dont les valeurs sont uniques pour l'objet." operationId: post-/crm/objects/2026-03/0-3/batch/upsert_upsert parameters: [] requestBody: content: application/json: schema: $ref: >- #/components/schemas/BatchInputSimplePublicObjectBatchInputUpsert required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseSimplePublicUpsertObject' '207': description: multiple statuses content: application/json: schema: $ref: >- #/components/schemas/BatchResponseSimplePublicUpsertObjectWithErrors default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: BatchInputSimplePublicObjectBatchInputUpsert: required: - inputs type: object properties: inputs: type: array description: >- Un tableau d'objets publics simples à insérer ou à mettre à jour. Chaque objet du tableau contient les données nécessaires à la création ou à la mise à jour d'une fiche d'informations dans HubSpot. items: $ref: '#/components/schemas/SimplePublicObjectBatchInputUpsert' description: >- Représente une opération d'entrée par lot pour l'upsert d'objets publics simples dans HubSpot. Cet élément est utilisé pour traiter plusieurs opérations d'upsert en une seule requête, améliorant ainsi l'efficacité et les performances. BatchResponseSimplePublicUpsertObject: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: "L'horodatage de la fin du processus de traitement par lots, au format ISO\_8601." format: date-time links: type: object additionalProperties: type: string description: >- Un objet contenant des liens pertinents relatifs à la demande de lot. requestedAt: type: string description: "L'horodatage du lancement du processus de traitement par lots, au format ISO\_8601." format: date-time results: type: array description: >- Un tableau d'éléments SimplePublicUpsertObject représentant les résultats de l'opération d'insertion par lot. items: $ref: '#/components/schemas/SimplePublicUpsertObject' startedAt: type: string description: "L'horodatage du début de l'exécution du processus de traitement par lots, au format ISO\_8601." format: date-time status: type: string description: "Statut de la demande de traitement par lots. La valeur attendue est «\_TERMINÉ\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: >- Représente le résultat d'une opération d'upsert par lots, y compris le statut de l'opération, les horodatages et une liste d'objets créés ou mis à jour avec succès. BatchResponseSimplePublicUpsertObjectWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: "L'horodatage de la fin du processus de traitement par lots, au format ISO\_8601." format: date-time errors: type: array items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Un objet contenant des liens pertinents relatifs à la demande de lot. numErrors: type: integer description: >- Le nombre d'erreurs rencontrées au cours du processus de traitement par lots. format: int32 requestedAt: type: string description: "L'horodatage du lancement du processus de traitement par lots, au format ISO\_8601." format: date-time results: type: array items: $ref: '#/components/schemas/SimplePublicUpsertObject' startedAt: type: string description: "L'horodatage du début de l'exécution du processus de traitement par lots, au format ISO\_8601." format: date-time status: type: string description: "Statut de la demande de traitement par lots. Peut être\_: «\_EN ATTENTE\_», «\_TRAITEMENT\_», «\_ANNULÉ\_» ou «\_TERMINÉ\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: >- Represents the response from a batch upsert operation, including the status, timestamps, successfully processed objects, and any errors that occurred during processing. SimplePublicObjectBatchInputUpsert: required: - id - properties type: object properties: id: type: string description: L'ID unique de l'objet. idProperty: type: string description: Le nom d'une propriété dont les valeurs sont uniques pour cet objet objectWriteTraceId: type: string description: Un identifiant permettant de tracer la demande de création. properties: type: object additionalProperties: type: string description: Paires clé-valeur représentant les propriétés de l'objet. description: >- Représente un objet utilisé dans les opérations d'upsert par lot, contenant l'identifiant unique d'un objet, ses propriétés, et facultativement le nom de la propriété unique et un ID de trace d'écriture. SimplePublicUpsertObject: required: - archived - createdAt - id - new - properties - updatedAt type: object properties: archived: type: boolean description: Si l'objet est archivé. archivedAt: type: string description: "L'horodatage du moment où l'objet a été archivé, au format ISO\_8601." format: date-time createdAt: type: string description: "L'horodatage du moment où l'objet a été créé, au format ISO\_8601." format: date-time id: type: string description: L'ID unique de l'objet. new: type: boolean description: Si l'objet est créé. objectWriteTraceId: type: string description: >- Un identifiant permettant de suivre la demande de création ou de mise à jour de l'objet. properties: type: object additionalProperties: type: string description: Paires clé-valeur représentant les propriétés de l'objet. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Paires clé-valeur représentant les propriétés de l'objet avec leur historique. updatedAt: type: string description: "L'horodatage du moment où l'objet a été mis à jour pour la dernière fois, au format ISO\_8601." format: date-time url: type: string description: L'URL associée à l'objet. warnings: type: array items: $ref: '#/components/schemas/PublicObjectWarning' description: Représente un objet CRM qui a été créé ou mis à jour (upserted) StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: La catégorie principale de l'erreur. context: type: object additionalProperties: type: array items: type: string description: Informations contextuelles supplémentaires relatives à l'erreur. errors: type: array description: Les objets d'erreur détaillés. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Un identifiant unique pour l'instance d'erreur. links: type: object additionalProperties: type: string description: >- URL renvoyant à la documentation ou aux ressources associées à l'erreur. message: type: string description: >- Chaîne lisible par l'homme décrivant l'erreur et les mesures correctives possibles. status: type: string description: Le code d'état HTTP associé à l'erreur. subCategory: type: object properties: {} description: >- Une catégorie d'erreurs plus spécifique au sein de chaque catégorie principale. 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 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 ValueWithTimestamp: required: - sourceType - timestamp - value type: object properties: sourceId: type: string description: L'ID unique de la propriété. sourceLabel: type: string description: Un libellé lisible par l'homme. sourceType: type: string description: Le type de propriété. timestamp: type: string description: "Date à laquelle la propriété a été mise à jour, au format ISO\_8601." format: date-time updatedByUserId: type: integer description: >- L'ID de l'utilisateur qui a mis à jour la propriété pour la dernière fois. format: int32 value: type: string description: La valeur de la propriété. description: Modèle de propriété qui inclut un horodatage. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: >- La classification de l'avertissement, indiquant le type ou la nature du problème. context: type: object additionalProperties: type: string description: >- Informations supplémentaires ou métadonnées concernant l'avertissement, fournissant un contexte pour la compréhension du problème. message: type: string description: >- Le texte du message d'avertissement, fournissant des informations sur le problème ou l'alerte. description: >- Représente un message d'avertissement lié à un objet public dans HubSpot, fournissant des détails sur la nature et le contexte de l'avertissement. 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é trouvée. 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' ````