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

# Start an export

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

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

## Request body

- union
  - CrmExportsPublicExportViewRequest
    - `associatedObjectType` string[], required
    - `exportInternalValuesOptions` string[], required
    - `exportName` string, required
    - `exportType` 'VIEW', required
    - `format` 'CSV' | 'XLS' | 'XLSX', required
    - `includeLabeledAssociations` boolean, required
    - `includePrimaryDisplayPropertyForAssociatedObjects` boolean, required
    - `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
    - `objectProperties` string[], required
    - `objectType` string, required
    - `overrideAssociatedObjectsPerDefinitionPerRowLimit` boolean, required
    - `publicCrmSearchRequest` CrmExportsPublicCrmSearchRequest
      - `filterGroups` CrmFilterGroup[], required
        - `filters` CrmFilter[], required
          - `highValue` string — The upper boundary value when using ranged-based filters.
          - `operator` 'BETWEEN' | 'CONTAINS_TOKEN' | 'EQ' | 'GT' | 'GTE' | 'HAS_PROPERTY' | 'IN' | 'LT' | 'LTE' | 'NEQ' | 'NOT_CONTAINS_TOKEN' | 'NOT_HAS_PROPERTY' | 'NOT_IN', required — The comparison operator used in the filter, such as "EQ" or "GT".
          - `propertyName` string, required — The name of the property to apply the filter to.
          - `value` string — The value to match against the property.
          - `values` string[] — The values to match against the property.
      - `filters` CrmFilter[], required
        - `highValue` string — The upper boundary value when using ranged-based filters.
        - `operator` 'BETWEEN' | 'CONTAINS_TOKEN' | 'EQ' | 'GT' | 'GTE' | 'HAS_PROPERTY' | 'IN' | 'LT' | 'LTE' | 'NEQ' | 'NOT_CONTAINS_TOKEN' | 'NOT_HAS_PROPERTY' | 'NOT_IN', required — The comparison operator used in the filter, such as "EQ" or "GT".
        - `propertyName` string, required — The name of the property to apply the filter to.
        - `value` string — The value to match against the property.
        - `values` string[] — The values to match against the property.
      - `query` string — The search query string, to filter CRM records.
      - `sorts` string[], required — Defines the order in which the CRM records should be returned.
  - CrmExportsPublicExportListRequest
    - `associatedObjectType` string[], required
    - `exportInternalValuesOptions` string[], required
    - `exportName` string, required
    - `exportType` 'LIST', required
    - `format` 'CSV' | 'XLS' | 'XLSX', required
    - `includeLabeledAssociations` boolean, required
    - `includePrimaryDisplayPropertyForAssociatedObjects` boolean, required
    - `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
    - `listId` string, required
    - `objectProperties` string[], required
    - `objectType` string, required
    - `overrideAssociatedObjectsPerDefinitionPerRowLimit` boolean, required

## Response `202`

accepted

- TaskLocator
  - `id` string, required — The unique identifier for the task.
  - `links` object — A map of link names to associated URIs containing documentation about the error or recommended remediation steps

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)