> ## 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 upsert > Effectuer une insertion par lots des paramètres d'auto-association dans votre compte HubSpot. Ce point de terminaison vous permet de mettre à jour ou d'insérer plusieurs personnalisations d'auto-association à la fois, ce qui simplifie la gestion de ces paramètres. Le corps de la requête doit inclure un tableau de personnalisations d'association à insérer. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2027-03-beta/crm-activity-auto-associations-v2027-03-beta.json POST /crm/auto-associations/2027-03-beta/batch/upsert openapi: 3.0.1 info: title: CRM Activity Auto Associations description: Basepom for all HubSpot Projects version: 2027-03-beta 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: Basic - name: Batch paths: /crm/auto-associations/2027-03-beta/batch/upsert: post: tags: - Batch summary: Insertion par lots description: >- Effectuer une insertion par lots des paramètres d'auto-association dans votre compte HubSpot. Ce point de terminaison vous permet de mettre à jour ou d'insérer plusieurs personnalisations d'auto-association à la fois, ce qui simplifie la gestion de ces paramètres. Le corps de la requête doit inclure un tableau de personnalisations d'association à insérer. operationId: post-/crm/auto-associations/2027-03-beta/batch/upsert parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AutoAssociationUpsertArgs' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseAutoAssociationBehavior' '207': description: multiple statuses content: application/json: schema: $ref: >- #/components/schemas/BatchResponseAutoAssociationBehaviorWithErrors default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: AutoAssociationUpsertArgs: required: - associationCustomizationsToUpsert type: object properties: associationCustomizationsToUpsert: type: array description: >- Un tableau d'objets AutoAssociationUpsertArg, chacun définissant un ensemble de personnalisations pour les associations. Cette propriété est obligatoire. items: $ref: '#/components/schemas/AutoAssociationUpsertArg' BatchResponseAutoAssociationBehavior: 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: >- Un objet contenant des paires clé-valeur où chaque clé est un nom de lien et chaque valeur est une chaîne URI liée à 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'objets AutoAssociationBehavior, représentant les résultats de l'opération par lot. items: $ref: '#/components/schemas/AutoAssociationBehavior' 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 BatchResponseAutoAssociationBehaviorWithErrors: 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 décrite par un objet StandardError. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées, fournissant une documentation ou des ressources supplémentaires liées à l'opération par lot. numErrors: type: integer description: Le nombre 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 comportements d'auto-association qui ont été traités dans l'opération par lot. items: $ref: '#/components/schemas/AutoAssociationBehavior' 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 AutoAssociationUpsertArg: required: - associationCustomization - engagementType - subjectObjectTypeId - targetObjectTypeId type: object properties: associationCustomization: type: string description: "Spécifie le comportement de personnalisation de l'association. Il s'agit d'une chaîne et les valeurs valides sont\_: «\_NO_LOGGING\_», «\_PRIMARY_COMPANY\_», « \__MOST_RECENTLY_ASSOCIATED\_», «\_ONE_MOST_RECENTLY_ASSOCIATED\_» et «\_FIVE_MOST_RECENTLY_ASSOCIATED\_»." enum: - FIVE_MOST_RECENTLY_ASSOCIATED - NO_LOGGING - ONE_MOST_RECENTLY_ASSOCIATED - PRIMARY_COMPANY - X_MOST_RECENTLY_ASSOCIATED engagementType: type: string description: >- Le type d'engagement qui est auto-associé. Il est représenté sous forme de chaîne de caractères. subjectObjectTypeId: type: string description: >- L'identifiant unique du type d'objet sujet impliqué dans l'auto-association. Il s'agit d'une chaîne. targetObjectTypeId: type: string description: >- L'identifiant unique du type d'objet cible impliqué dans l'auto-association. C'est une chaîne de caractères. AutoAssociationBehavior: required: - associationCustomization - engagementType - id - subjectObjectTypeId - targetObjectTypeId type: object properties: associationCustomization: type: string description: "Spécifie le comportement de personnalisation pour l'association. Il s'agit d'une chaîne et peut prendre l'une des valeurs suivantes : «\_NO_LOGGING\_», «\_PRIMARY_COMPANY\_», «\_X_MOST_RECENTLY_ASSOCIATED\_», «\_ONE_MOST_RECENTLY_ASSOCIATED\_», «\_FIVE_MOST_RECENTLY_ASSOCIATED\_»." enum: - FIVE_MOST_RECENTLY_ASSOCIATED - NO_LOGGING - ONE_MOST_RECENTLY_ASSOCIATED - PRIMARY_COMPANY - X_MOST_RECENTLY_ASSOCIATED engagementType: type: string description: Le type d'engagement associé. C'est une chaîne de caractères. id: type: string description: >- L'identifiant unique de ce paramètre de comportement d'auto-association spécifique. subjectObjectTypeId: type: string description: >- L'identifiant unique du type d'objet sujet impliqué dans l'association. Il s'agit d'une chaîne de caractères. targetObjectTypeId: type: string description: >- L'identifiant unique du type d'objet cible impliqué dans l'association. Il s'agit d'une chaîne de caractères. 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 supplémentaire sur la condition d'erreur, avec des clés comme noms de contexte et des valeurs comme tableaux de chaînes de caractères. errors: type: array description: >- Un tableau d'objets ErrorDetail fournissant des informations supplémentaires sur l'erreur. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Une chaîne représentant un identifiant unique pour 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: Ye olde error Error: required: - category - correlationId - message type: object properties: category: type: string description: >- La catégorie d'erreur, pour fournir une classification de haut niveau de l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, représenté sous la forme d'un objet avec des propriétés supplémentaires qui peuvent inclure des tableaux de chaînes. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance. Il est formaté comme un UUID. 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 détaillant les conditions d'erreur spécifiques. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant la documentation sur l'erreur ou les étapes de remédiation recommandées. 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. example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur. Il s'agit d'une propriété de type chaîne de caractères. 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 de statut associé au détail de l'erreur, représenté sous forme de chaîne de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, représenté sous forme d'objet. Cet objet peut contenir des propriétés supplémentaires, chacune étant un tableau de chaînes de caractères, fournissant des détails supplémentaires sur l'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 chaîne de caractères qui permet d'identifier la source de l'erreur. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Cette propriété est obligatoire. subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur, fournie sous forme de chaîne de caractères. 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' ````