> ## 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. # Upsert courses > 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-courses-v2026-03.json POST /crm/objects/2026-03/0-410/batch/upsert openapi: 3.0.1 info: title: Formations 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-introduction: >- Utilisez l’API des formations pour créer et gérer des fiches d'informations CRM représentant des informations sur un programme structuré ou une série de leçons, formations ou modules éducatifs. Identifiez le type d’objet formation grâce à son ID de type d’objet 0-410 servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Search paths: /crm/objects/2026-03/0-410/batch/upsert: post: tags: - Batch summary: Insérer des cours 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-410/batch/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'éléments SimplePublicObjectBatchInputUpsert, chacun représentant un objet à upserter. Chaque élément contient les propriétés et les identifiants nécessaires à l'opération d'upsertion. 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: >- La date et l'heure auxquelles l'opération de lot a été effectuée, au format ISO 8601. format: date-time links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées, fournissant des informations supplémentaires sur l'opération de lot. requestedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été demandée, 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: >- La date et l'heure de début de l'opération par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel de l'opération par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." 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: >- La date et l'heure auxquelles l'opération de lot a été effectuée, au format ISO 8601. format: date-time errors: type: array description: >- Un tableau d'erreurs survenues pendant l'opération par lot, chacune représentée comme une erreur standard. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées contenant la documentation sur l'opération par lot. numErrors: type: integer description: Le nombre total d'erreurs survenues pendant l'opération par lot. format: int32 requestedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été demandée, au format ISO 8601. format: date-time results: type: array description: >- Un tableau de résultats de l'opération d'upsert par lot, chacun représenté comme un SimplePublicUpsertObject. items: $ref: '#/components/schemas/SimplePublicUpsertObject' startedAt: type: string description: >- La date et l'heure de début de l'opération par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel de l'opération par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." 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: Une chaîne représentant l'identifiant unique de l'objet CRM. idProperty: type: string description: >- Une chaîne spécifiant le nom d'une propriété dont les valeurs sont uniques pour ce type d'objet. objectWriteTraceId: type: string description: >- Une chaîne utilisée pour tracer l'opération d'écriture à des fins de débogage ou de journalisation. properties: type: object additionalProperties: type: string description: >- Un objet contenant des paires clé-valeur représentant les propriétés de l'objet CRM. Chaque clé est un nom de propriété, et chaque valeur est la valeur de la propriété. 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: Indique si l'objet est archivé. Une valeur booléenne. archivedAt: type: string description: La date et l'heure d'archivage de cet objet, au format ISO 8601. format: date-time createdAt: type: string description: La date et l'heure de création de cet objet, au format ISO 8601. format: date-time id: type: string description: L'identifiant unique de cet objet. new: type: boolean description: Indique si l'objet est nouvellement créé. Une valeur booléenne. objectWriteTraceId: type: string description: >- Un ID de suivi pour l'opération d'écriture qui a créé ou mis à jour cet objet. properties: type: object additionalProperties: type: string description: >- Une carte des noms de propriétés et de leurs valeurs, représentant les données de l'objet. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Une carte des noms de propriétés vers des tableaux de leurs valeurs historiques, chaque entrée contenant une valeur et un horodatage. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de cet objet, au format ISO 8601. format: date-time url: type: string description: L'URL de l'objet dans HubSpot. warnings: type: array description: >- Un tableau d'avertissements liés à l'objet, chacun contenant une catégorie, un message et un contexte. 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: Une chaîne qui catégorise l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur la condition d'erreur. Chaque clé correspond à un tableau de chaînes de caractères. errors: type: array description: >- Un tableau d'objets ErrorDetail fournissant des détails supplémentaires sur l'erreur. 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 des détails plus spécifiques sur la catégorie d'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 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: Une chaîne représentant l'identifiant unique de la source. sourceLabel: type: string description: Chaîne fournissant une étiquette ou une description pour la source. sourceType: type: string description: Une chaîne indiquant le type de source d'où provient la valeur. timestamp: type: string description: >- La date et l'heure d'enregistrement de la fiche d'informations, au format ISO 8601. format: date-time updatedByUserId: type: integer description: >- Un nombre entier représentant l'ID de l'utilisateur ayant mis à jour la valeur pour la dernière fois. format: int32 value: type: string description: Une chaîne représentant la valeur de données. description: Modèle de propriété qui inclut un horodatage. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: Chaîne représentant la catégorie de l'avertissement. context: type: object additionalProperties: type: string description: >- Un objet fournissant un contexte supplémentaire pour l'avertissement, avec des propriétés de chaîne. message: type: string description: Chaîne contenant le message d'avertissement. 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é 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' ````