Create Export Lead Job¶
POST /bulk/v1/leads/export/create.json
Method: POST
Path: /bulk/v1/leads/export/create.json
Tag: Bulk Export Leads
Operation ID: createExportLeadsUsingPOST
Create export job for search criteria defined via "filter" parameter. Request returns the "exportId" which is passed as a parameter in subsequent calls to Bulk Export Leads endpoints. Use Enqueue Export Lead Job endpoint to queue the export job for processing. Use Get Export Lead Job Status endpoint to retrieve status of export job. Required Permissions: Read-Only Lead
Formats¶
- Request:
application/json - Response:
application/json
Request¶
Request body¶
Name: exportLeadRequest
Required: No
Schema: model: ExportLeadRequest
exportLeadRequest
ColumnHeaderNames: A JSON object containing key-value pairs of field and column header names.
Example:"columnHeaderNames":{
"firstName":"First Name",
"lastName":"Last Name",
"email":"Email Address"
}
Generated example¶
{
"columnHeaderNames": {
"name": "Example name",
"value": "string"
},
"fields": [
"string"
],
"filter": {
"createdAt": {
"endAt": "string",
"startAt": "string"
},
"smartListId": 123,
"smartListName": "Example name",
"staticListId": 123,
"staticListName": "Example name",
"updatedAt": {
"endAt": "string",
"startAt": "string"
}
},
"format": "string"
}
Referenced models¶
Example request¶
POST {{base_url}}/bulk/v1/leads/export/create.json
Content-Type: application/json
Accept: application/json
{
"columnHeaderNames": {
"name": "Example name",
"value": "string"
},
"fields": [
"string"
],
"filter": {
"createdAt": {
"endAt": "string",
"startAt": "string"
},
"smartListId": 123,
"smartListName": "Example name",
"staticListId": 123,
"staticListName": "Example name",
"updatedAt": {
"endAt": "string",
"startAt": "string"
}
},
"format": "string"
}
Responses¶
200 — OK¶
Schema: model: ResponseOfExportResponse
Generated example¶
{
"errors": [
{
"code": "string",
"message": "string"
}
],
"requestId": "123",
"result": [
{
"createdAt": "2026-01-15T10:30:00Z",
"errorMsg": "string",
"exportId": "123",
"fileSize": 123,
"fileChecksum": "string",
"finishedAt": "2026-01-15T10:30:00Z",
"format": "string",
"numberOfRecords": 123,
"queuedAt": "2026-01-15T10:30:00Z",
"startedAt": "2026-01-15T10:30:00Z",
"status": "string"
}
],
"success": false,
"warnings": [
{
"code": 123,
"message": "string"
}
]
}
Referenced models¶
Source¶
Generated from swagger-mapi.json.
Generated examples are inferred from the schema. They are illustrative and may not be valid production payloads.