Start an export

Lancer un export

curl --request POST \
  --url https://api.hubapi.com/crm/exports/2026-03/export/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "associatedObjectType": [
    "<string>"
  ],
  "exportInternalValuesOptions": [],
  "exportName": "<string>",
  "exportType": "VIEW",
  "includeLabeledAssociations": true,
  "includePrimaryDisplayPropertyForAssociatedObjects": true,
  "objectProperties": [
    "<string>"
  ],
  "objectType": "<string>",
  "overrideAssociatedObjectsPerDefinitionPerRowLimit": true
}
'

import requests

url = "https://api.hubapi.com/crm/exports/2026-03/export/async"

payload = {
    "associatedObjectType": ["<string>"],
    "exportInternalValuesOptions": [],
    "exportName": "<string>",
    "exportType": "VIEW",
    "includeLabeledAssociations": True,
    "includePrimaryDisplayPropertyForAssociatedObjects": True,
    "objectProperties": ["<string>"],
    "objectType": "<string>",
    "overrideAssociatedObjectsPerDefinitionPerRowLimit": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    associatedObjectType: ['<string>'],
    exportInternalValuesOptions: [],
    exportName: '<string>',
    exportType: 'VIEW',
    includeLabeledAssociations: true,
    includePrimaryDisplayPropertyForAssociatedObjects: true,
    objectProperties: ['<string>'],
    objectType: '<string>',
    overrideAssociatedObjectsPerDefinitionPerRowLimit: true
  })
};

fetch('https://api.hubapi.com/crm/exports/2026-03/export/async', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/crm/exports/2026-03/export/async",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'associatedObjectType' => [
        '<string>'
    ],
    'exportInternalValuesOptions' => [
        
    ],
    'exportName' => '<string>',
    'exportType' => 'VIEW',
    'includeLabeledAssociations' => true,
    'includePrimaryDisplayPropertyForAssociatedObjects' => true,
    'objectProperties' => [
        '<string>'
    ],
    'objectType' => '<string>',
    'overrideAssociatedObjectsPerDefinitionPerRowLimit' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/crm/exports/2026-03/export/async"

	payload := strings.NewReader("{\n  \"associatedObjectType\": [\n    \"<string>\"\n  ],\n  \"exportInternalValuesOptions\": [],\n  \"exportName\": \"<string>\",\n  \"exportType\": \"VIEW\",\n  \"includeLabeledAssociations\": true,\n  \"includePrimaryDisplayPropertyForAssociatedObjects\": true,\n  \"objectProperties\": [\n    \"<string>\"\n  ],\n  \"objectType\": \"<string>\",\n  \"overrideAssociatedObjectsPerDefinitionPerRowLimit\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/crm/exports/2026-03/export/async")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"associatedObjectType\": [\n    \"<string>\"\n  ],\n  \"exportInternalValuesOptions\": [],\n  \"exportName\": \"<string>\",\n  \"exportType\": \"VIEW\",\n  \"includeLabeledAssociations\": true,\n  \"includePrimaryDisplayPropertyForAssociatedObjects\": true,\n  \"objectProperties\": [\n    \"<string>\"\n  ],\n  \"objectType\": \"<string>\",\n  \"overrideAssociatedObjectsPerDefinitionPerRowLimit\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/crm/exports/2026-03/export/async")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"associatedObjectType\": [\n    \"<string>\"\n  ],\n  \"exportInternalValuesOptions\": [],\n  \"exportName\": \"<string>\",\n  \"exportType\": \"VIEW\",\n  \"includeLabeledAssociations\": true,\n  \"includePrimaryDisplayPropertyForAssociatedObjects\": true,\n  \"objectProperties\": [\n    \"<string>\"\n  ],\n  \"objectType\": \"<string>\",\n  \"overrideAssociatedObjectsPerDefinitionPerRowLimit\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "links": {}
}

{
  "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"
  }
}

POST

crm

exports

2026-03

export

async

Lancer un export

curl --request POST \
  --url https://api.hubapi.com/crm/exports/2026-03/export/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "associatedObjectType": [
    "<string>"
  ],
  "exportInternalValuesOptions": [],
  "exportName": "<string>",
  "exportType": "VIEW",
  "includeLabeledAssociations": true,
  "includePrimaryDisplayPropertyForAssociatedObjects": true,
  "objectProperties": [
    "<string>"
  ],
  "objectType": "<string>",
  "overrideAssociatedObjectsPerDefinitionPerRowLimit": true
}
'

import requests

url = "https://api.hubapi.com/crm/exports/2026-03/export/async"

payload = {
    "associatedObjectType": ["<string>"],
    "exportInternalValuesOptions": [],
    "exportName": "<string>",
    "exportType": "VIEW",
    "includeLabeledAssociations": True,
    "includePrimaryDisplayPropertyForAssociatedObjects": True,
    "objectProperties": ["<string>"],
    "objectType": "<string>",
    "overrideAssociatedObjectsPerDefinitionPerRowLimit": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    associatedObjectType: ['<string>'],
    exportInternalValuesOptions: [],
    exportName: '<string>',
    exportType: 'VIEW',
    includeLabeledAssociations: true,
    includePrimaryDisplayPropertyForAssociatedObjects: true,
    objectProperties: ['<string>'],
    objectType: '<string>',
    overrideAssociatedObjectsPerDefinitionPerRowLimit: true
  })
};

fetch('https://api.hubapi.com/crm/exports/2026-03/export/async', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/crm/exports/2026-03/export/async",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'associatedObjectType' => [
        '<string>'
    ],
    'exportInternalValuesOptions' => [
        
    ],
    'exportName' => '<string>',
    'exportType' => 'VIEW',
    'includeLabeledAssociations' => true,
    'includePrimaryDisplayPropertyForAssociatedObjects' => true,
    'objectProperties' => [
        '<string>'
    ],
    'objectType' => '<string>',
    'overrideAssociatedObjectsPerDefinitionPerRowLimit' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/crm/exports/2026-03/export/async"

	payload := strings.NewReader("{\n  \"associatedObjectType\": [\n    \"<string>\"\n  ],\n  \"exportInternalValuesOptions\": [],\n  \"exportName\": \"<string>\",\n  \"exportType\": \"VIEW\",\n  \"includeLabeledAssociations\": true,\n  \"includePrimaryDisplayPropertyForAssociatedObjects\": true,\n  \"objectProperties\": [\n    \"<string>\"\n  ],\n  \"objectType\": \"<string>\",\n  \"overrideAssociatedObjectsPerDefinitionPerRowLimit\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/crm/exports/2026-03/export/async")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"associatedObjectType\": [\n    \"<string>\"\n  ],\n  \"exportInternalValuesOptions\": [],\n  \"exportName\": \"<string>\",\n  \"exportType\": \"VIEW\",\n  \"includeLabeledAssociations\": true,\n  \"includePrimaryDisplayPropertyForAssociatedObjects\": true,\n  \"objectProperties\": [\n    \"<string>\"\n  ],\n  \"objectType\": \"<string>\",\n  \"overrideAssociatedObjectsPerDefinitionPerRowLimit\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/crm/exports/2026-03/export/async")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"associatedObjectType\": [\n    \"<string>\"\n  ],\n  \"exportInternalValuesOptions\": [],\n  \"exportName\": \"<string>\",\n  \"exportType\": \"VIEW\",\n  \"includeLabeledAssociations\": true,\n  \"includePrimaryDisplayPropertyForAssociatedObjects\": true,\n  \"objectProperties\": [\n    \"<string>\"\n  ],\n  \"objectType\": \"<string>\",\n  \"overrideAssociatedObjectsPerDefinitionPerRowLimit\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "links": {}
}

{
  "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"
  }
}

Supported products

Required Scopes

Autorisations

Authorization

string

header

requis

The access token received from the authorization server in the OAuth 2.0 flow.

Corps

application/json

Option 1
Option 2

associatedObjectType

string[]

requis

Un tableau de chaînes de caractères indiquant les types d’objets associés à inclure dans l’export.

exportInternalValuesOptions

enum<string>[]

requis

Un tableau de chaînes spécifiant les options pour les valeurs internes dans l'export. Les valeurs valides sont « NAMES » et « VALUES ».

Options disponibles:

NAMES,

VALUES

exportName

string

requis

Le nom attribué à l'export, représenté sous forme de chaîne de caractères.

exportType

enum<string>

défaut:VIEW

requis

Le type d'export demandé. La seule valeur valide est « VIEW ».

Options disponibles:

VIEW

format

enum<string>

requis

Le format de fichier pour l' export. Les options valides sont « XLS », « XLSX » et « CSV ».

Options disponibles:

CSV,

XLS,

XLSX

includeLabeledAssociations

boolean

requis

Un booléen indiquant si les associations étiquetées doivent être incluses dans l'export.

includePrimaryDisplayPropertyForAssociatedObjects

boolean

requis

Un booléen indiquant si la propriété d'affichage principale des objets associés doit être incluse.

language

enum<string>

requis

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 ».

Options disponibles:

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

string[]

requis

Un tableau de chaînes spécifiant les propriétés de l'objet à inclure dans l'exportation.

objectType

string

requis

Une chaîne représentant le type d'objet exporté.

overrideAssociatedObjectsPerDefinitionPerRowLimit

boolean

requis

Un booléen indiquant d'outrepasser la limite d'objets associés par définition par ligne.

publicCrmSearchRequest

object

Show child attributes

Réponse

accepted

string

requis

Identifiant unique de l'export.

links

object

Un objet contenant des liens pertinents liés au processus d'export.

Show child attributes

Dernière modification le 6 octobre 2026

Compte et paramètres

Gestion des applications

Authentification

Automatisation

CMS

Préférences de communication

Conversations

CRM

Événements

Fichiers

Marketing

Planificateur

Webhooks

Journal des webhooks

Autorisations

Corps

Réponse