---
title: "Start an export"
method: POST
path: "/crm/exports/2026-09/export/async"
tags: ["Advanced"]
---

# Start an export

`POST /crm/exports/2026-09/export/async`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/exports/2026-09/export/async`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.export`

Begins exporting CRM data for the portal as specified in the request body

## Request body

- union
  - object
    - `associatedObjectType` string[], required: An array of strings indicating the types of associated objects to include in the export.
    - `exportInternalValuesOptions` string[], required: An array of strings specifying options for internal values in the export. Valid values are 'NAMES' and 'VALUES'.
    - `exportName` string, required: The name assigned to the export, represented as a string.
    - `exportType` 'VIEW', required: The type of export being requested. The only valid value is 'VIEW'.
    - `format` 'CSV' | 'XLS' | 'XLSX', required: The file format for the export. Valid options are 'XLS', 'XLSX', and 'CSV'.
    - `includeLabeledAssociations` boolean, required: A boolean indicating whether labeled associations should be included in the export.
    - `includePrimaryDisplayPropertyForAssociatedObjects` boolean, required: A boolean indicating whether the primary display property for associated objects should be included.
    - `language` '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', required: The language code for the export. Valid values include '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'.
    - `objectProperties` string[], required: An array of strings specifying the properties of the object to be included in the export.
    - `objectType` string, required: A string representing the type of object being exported.
    - `overrideAssociatedObjectsPerDefinitionPerRowLimit` boolean, required: A boolean indicating whether to override the limit of associated objects per definition per row.
    - `publicCrmSearchRequest` PublicCrmSearchRequest
      - `filterGroups` FilterGroup[], required: An array of filter groups, where each group contains multiple filters. This allows for complex filtering logic by combining multiple filters together.
        - `filters` Filter[], required: An array of filter objects that define the criteria for the filter group. Each filter specifies a property, an operator, and a value to be used in the filtering process.
          - `highValue` string: A string representing the upper boundary value used with the 'BETWEEN' operator.
          - `operator` 'BETWEEN' | 'CONTAINS_TOKEN' | 'EQ' | 'GT' | 'GTE' | 'HAS_PROPERTY' | 'IN' | 'LT' | 'LTE' | 'NEQ' | 'NOT_CONTAINS_TOKEN' | 'NOT_HAS_PROPERTY' | 'NOT_IN', required: The operator used to compare the property value against the specified value(s). Valid operators include 'EQ', 'NEQ', 'LT', 'LTE', 'GT', 'GTE', 'BETWEEN', 'IN', 'NOT_IN', 'HAS_PROPERTY', 'NOT_HAS_PROPERTY', 'CONTAINS_TOKEN', and 'NOT_CONTAINS_TOKEN'.
          - `propertyName` string, required: The name of the property to filter by. This is a string value.
          - `value` string: A string representing the value to compare the property against when using certain operators.
          - `values` string[]: An array of string values used with operators like 'IN' and 'NOT_IN' to specify multiple comparison values.
      - `filters` Filter[], required: An array of filter objects used to specify the criteria for the search. Each filter defines a property, an operator, and a value to filter by.
        - `highValue` string: A string representing the upper boundary value used with the 'BETWEEN' operator.
        - `operator` 'BETWEEN' | 'CONTAINS_TOKEN' | 'EQ' | 'GT' | 'GTE' | 'HAS_PROPERTY' | 'IN' | 'LT' | 'LTE' | 'NEQ' | 'NOT_CONTAINS_TOKEN' | 'NOT_HAS_PROPERTY' | 'NOT_IN', required: The operator used to compare the property value against the specified value(s). Valid operators include 'EQ', 'NEQ', 'LT', 'LTE', 'GT', 'GTE', 'BETWEEN', 'IN', 'NOT_IN', 'HAS_PROPERTY', 'NOT_HAS_PROPERTY', 'CONTAINS_TOKEN', and 'NOT_CONTAINS_TOKEN'.
        - `propertyName` string, required: The name of the property to filter by. This is a string value.
        - `value` string: A string representing the value to compare the property against when using certain operators.
        - `values` string[]: An array of string values used with operators like 'IN' and 'NOT_IN' to specify multiple comparison values.
      - `query` string: The search query string, to filter CRM records.
      - `sorts` string[], required: Defines the order in which the CRM records should be returned.
  - object
    - `associatedObjectType` string[], required: An array of strings specifying the types of associated objects to include in the export.
    - `exportInternalValuesOptions` string[], required: An array of strings indicating options for exporting internal values. Valid values are 'NAMES' and 'VALUES'.
    - `exportName` string, required: A string representing the name of the export.
    - `exportType` 'LIST', required: A string indicating the type of export, which is 'LIST' by default.
    - `format` 'CSV' | 'XLS' | 'XLSX', required: A string specifying the format of the export file. Valid values are 'XLS', 'XLSX', and 'CSV'.
    - `includeLabeledAssociations` boolean, required: A boolean indicating whether to include labeled associations in the export.
    - `includePrimaryDisplayPropertyForAssociatedObjects` boolean, required: A boolean indicating whether to include the primary display property for associated objects.
    - `language` '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', required: A string specifying the language for the export. Valid values include language codes such as 'EN', 'FR', 'DE', etc.
    - `listId` string, required: A string representing the ID of the list to be exported.
    - `objectProperties` string[], required: An array of strings listing the properties of the objects to be included in the export.
    - `objectType` string, required: A string representing the type of objects being exported.
    - `overrideAssociatedObjectsPerDefinitionPerRowLimit` boolean, required: A boolean indicating whether to override the limit on associated objects per definition per row.

## Response `202`

accepted

- TaskLocator
  - `id` string, required: The unique ID of the export.
  - `links` object: An object containing relevant links related to the export process.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `332056e515b9`: 23 breaking, 2 warning, 4 info
  - added the new required request property `oneOf[#/components/schemas/PublicExportListRequest]/associatedObjectType`
  - added the new required request property `oneOf[#/components/schemas/PublicExportListRequest]/exportInternalValuesOptions`
  - added the new required request property `oneOf[#/components/schemas/PublicExportListRequest]/exportName`
  - added the new required request property `oneOf[#/components/schemas/PublicExportListRequest]/format`
  - …25 more

[Operation history](https://skmtc.dev/hubspot/apis/crm-exports/changes/crm/exports/2026-09/export/async/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-exports.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-exports/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-exports/revisions/88aba8e617fe?raw)