> ## 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. # Start an export > Commence l'exportation des données du CRM pour le portail conformément à la demande > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-exports-v2026-09.json POST /crm/exports/2026-09/export/async openapi: 3.0.1 info: title: CRM Exports description: Basepom for all HubSpot Projects version: 2026-09 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 paths: /crm/exports/2026-09/export/async: post: tags: - Advanced summary: Lancer un export description: >- Commence l'exportation des données du CRM pour le portail conformément à la demande operationId: post-/crm/exports/2026-09/export/async_start parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicExportRequest' required: true responses: '202': description: accepted content: application/json: schema: $ref: '#/components/schemas/TaskLocator' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.export components: schemas: PublicExportRequest: properties: {} oneOf: - $ref: '#/components/schemas/PublicExportViewRequest' - $ref: '#/components/schemas/PublicExportListRequest' TaskLocator: required: - id type: object properties: id: type: string description: Identifiant unique de l'export. links: type: object additionalProperties: type: string description: Un objet contenant des liens pertinents liés au processus d'export. PublicExportViewRequest: required: - associatedObjectType - exportInternalValuesOptions - exportName - exportType - format - includeLabeledAssociations - includePrimaryDisplayPropertyForAssociatedObjects - language - objectProperties - objectType - overrideAssociatedObjectsPerDefinitionPerRowLimit type: object properties: associatedObjectType: type: array description: >- Un tableau de chaînes de caractères indiquant les types d’objets associés à inclure dans l’export. items: type: string exportInternalValuesOptions: type: array description: "Un tableau de chaînes spécifiant les options pour les valeurs internes dans l'export. Les valeurs valides sont «\_NAMES\_» et «\_VALUES\_»." items: type: string enum: - NAMES - VALUES exportName: type: string description: >- Le nom attribué à l'export, représenté sous forme de chaîne de caractères. exportType: type: string description: "Le type d'export demandé. La seule valeur valide est «\_VIEW\_»." default: VIEW enum: - VIEW format: type: string description: "Le format de fichier pour l' export. Les options valides sont «\_XLS\_», «\_XLSX\_» et «\_CSV\_»." enum: - CSV - XLS - XLSX includeLabeledAssociations: type: boolean description: >- Un booléen indiquant si les associations étiquetées doivent être incluses dans l'export. includePrimaryDisplayPropertyForAssociatedObjects: type: boolean description: >- Un booléen indiquant si la propriété d'affichage principale des objets associés doit être incluse. language: type: string description: "Le code de langue pour l'export. Les valeurs valides incluent «\_EN\_», «\_FR\_», «\_DE\_», «\_JA\_», «\_ES\_», «\_PT_BR\_», «\_NL\_», «\_BN\_», «\_CS\_», «\_DA_DK\_», «\_EL_GR\_», «\_ES_MX\_», «\_FI\_», «\_HR\_», «\_HU\_», «\_ID\_», «\_IT\_», «\_KO_KR\_», «\_NO\_», «\_PL\_», «\_RO\_», «\_RU\_», «\_SV\_», «\_TH\_», «\_VI_VN\_», «\_ZH_CN\_», «\_ZH_HK\_», «\_AF_ZA\_», «\_AR_EG\_», «\_BG\_», «\_CA_ES\_», «\_SL\_», «\_TR\_», «\_UK\_», «\_EN_GB\_», «\_FR_CA\_», «\_HE_IL\_», «\_LT_LT\_», «\_PT_PT\_», «\_SK_SK\_», «\_MS\_», «\_TL\_», «\_ZH_TW\_», «\_HI_IN\_», «\_ET_EE\_»." enum: - AF_ZA - AR_EG - BG - BN - CA_ES - CS - DA_DK - DE - EL_GR - EN - EN_GB - ES - ES_MX - ET_EE - FI - FR - FR_CA - HE_IL - HI_IN - HR - HU - ID - IT - JA - KO_KR - LT_LT - MS - NL - 'NO' - PL - PT_BR - PT_PT - RO - RU - SK_SK - SL - SV - TH - TL - TR - UK - VI_VN - ZH_CN - ZH_HK - ZH_TW objectProperties: type: array description: >- Un tableau de chaînes spécifiant les propriétés de l'objet à inclure dans l'exportation. items: type: string objectType: type: string description: Une chaîne représentant le type d'objet exporté. overrideAssociatedObjectsPerDefinitionPerRowLimit: type: boolean description: >- Un booléen indiquant d'outrepasser la limite d'objets associés par définition par ligne. publicCrmSearchRequest: $ref: '#/components/schemas/PublicCrmSearchRequest' x-hubspot-sub-type-impl: true PublicExportListRequest: required: - associatedObjectType - exportInternalValuesOptions - exportName - exportType - format - includeLabeledAssociations - includePrimaryDisplayPropertyForAssociatedObjects - language - listId - objectProperties - objectType - overrideAssociatedObjectsPerDefinitionPerRowLimit type: object properties: associatedObjectType: type: array description: >- Un tableau de chaînes de caractères spécifiant les types d'objets associés à inclure dans l'exportation. items: type: string exportInternalValuesOptions: type: array description: "Un tableau de chaînes indiquant les options d'exportation des valeurs internes. Les valeurs valides sont «\_NAMES\_» et «\_VALUES\_»." items: type: string enum: - NAMES - VALUES exportName: type: string description: Une chaîne de caractères représentant le nom de l'export. exportType: type: string description: "Une chaîne indiquant le type d'export, qui est «\_LIST\_» par défaut." default: LIST enum: - LIST format: type: string description: "Une chaîne de caractères spécifiant le format du fichier d'exportation. Les valeurs valides sont «\_XLS\_», «\_XLSX\_» et «\_CSV\_»." enum: - CSV - XLS - XLSX includeLabeledAssociations: type: boolean description: >- Un booléen indiquant s'il faut inclure les associations étiquetées dans l'export. includePrimaryDisplayPropertyForAssociatedObjects: type: boolean description: >- Un booléen indiquant s'il faut inclure la propriété d'affichage principale pour les objets associés. language: type: string description: "Une chaîne spécifiant la langue de l'export. Les valeurs valides incluent des codes de langue, tels que «\_EN\_», «\_FR\_», «\_DE\_», etc." enum: - AF_ZA - AR_EG - BG - BN - CA_ES - CS - DA_DK - DE - EL_GR - EN - EN_GB - ES - ES_MX - ET_EE - FI - FR - FR_CA - HE_IL - HI_IN - HR - HU - ID - IT - JA - KO_KR - LT_LT - MS - NL - 'NO' - PL - PT_BR - PT_PT - RO - RU - SK_SK - SL - SV - TH - TL - TR - UK - VI_VN - ZH_CN - ZH_HK - ZH_TW listId: type: string description: Une chaîne de caractères représentant l'ID de la liste à exporter. objectProperties: type: array description: >- Un tableau de chaînes de caractères listant les propriétés des objets à inclure dans l'export. items: type: string objectType: type: string description: Une chaîne de caractères représentant le type d'objets exportés. overrideAssociatedObjectsPerDefinitionPerRowLimit: type: boolean description: >- Un booléen indiquant s'il faut outrepasser la limite d'objets associés par définition par ligne. x-hubspot-sub-type-impl: true 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 PublicCrmSearchRequest: required: - filterGroups - filters - sorts type: object properties: filterGroups: type: array description: >- Un tableau de groupes de filtres, où chaque groupe contient plusieurs filtres. Cela permet une logique de filtrage complexe en combinant plusieurs filtres. items: $ref: '#/components/schemas/FilterGroup' filters: type: array description: >- Un tableau d'objets de filtre utilisés pour spécifier les critères de recherche. Chaque filtre définit une propriété, un opérateur et une valeur à filtrer. items: $ref: '#/components/schemas/Filter' query: type: string description: >- La chaîne de requête de recherche permettant de filtrer les fiches d'informations CRM. sorts: type: array description: >- Définit l'ordre dans lequel les fiches d'informations CRM doivent être renvoyées. items: type: string 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. FilterGroup: required: - filters type: object properties: filters: type: array description: >- Un tableau d'objets de filtre qui définissent les critères du groupe de filtres. Chaque filtre spécifie une propriété, un opérateur et une valeur à utiliser dans le processus de filtrage. items: $ref: '#/components/schemas/Filter' description: >- Représente un groupe de filtres utilisés pour interroger des données dans HubSpot. Ce composant est utilisé pour définir des critères de filtrage des fiches d'informations dans divers points de terminaison d'API. Filter: required: - operator - propertyName type: object properties: highValue: type: string description: "Une chaîne de caractères représentant la valeur de la limite supérieure utilisée avec l'opérateur «\_BETWEEN\_»." operator: type: string description: "L'opérateur utilisé pour comparer la valeur de la propriété aux valeurs spécifiées. Les opérateurs valides incluent «\_EQ\_», «\_NEQ\_», «\_LT\_», «\_LTE\_», «\_GT\_», «\_GTE\_», «\_BETWEEN\_», «\_IN\_», «\_NOT_IN\_», «\_HAS_PROPERTY\_», «\_NOT_HAS_PROPERTY\_», «\_CONTAINS_TOKEN\_» et «\_NOT_CONTAINS_TOKEN\_»." enum: - BETWEEN - CONTAINS_TOKEN - EQ - GT - GTE - HAS_PROPERTY - IN - LT - LTE - NEQ - NOT_CONTAINS_TOKEN - NOT_HAS_PROPERTY - NOT_IN propertyName: type: string description: Le nom de la propriété à filtrer. Il s'agit d'une valeur de chaîne. value: type: string description: >- Une chaîne représentant la valeur à laquelle comparer la propriété lors de l'utilisation de certains opérateurs. values: type: array description: "Un tableau de valeurs de chaîne utilisé avec des opérateurs tels que «\_IN\_» et «\_NOT_IN\_» pour spécifier plusieurs valeurs de comparaison." items: type: string description: >- Defines a single condition for searching CRM objects, specifying the property to filter on, the operator to use (such as equals, greater than, or contains), and the value(s) to compare against. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.export: '' ````