Developer
API REFERENCE

Bulk operations API

12 REST endpoints for bulk operations, each with its parameters, the response it returns and a runnable curl example. Starts with GET /api/bulk/export.csv.

GET/api/bulk/export.csv

The Bulk Edit layout as a CSV, for editing offline.

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
domainIdqueryOptional query parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/bulk/import

Run the import

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 4
NameInDescription
domainIdbodyJSON request field
textbodyJSON request field
rowsbodyJSON request field
mappingbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/bulk/jobs

Get bulk jobs

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/bulk/jobs/{id}/errors.csv

Get bulk jobs by ID errors.csv

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
idpathRequired path parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/bulk/migration/bitly

Bitly migration

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/bulk/migration/bitly

Create or update bulk migration bitly

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 3
NameInDescription
sourceDomainbodyJSON request field
domainIdbodyJSON request field
enabledbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/bulk/preview

Preview an uploaded file (column mapping UI)

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
textbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/bulk/sheet

Bulk sheets — in-app grid (v2) load & apply

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Parameters 2
NameInDescription
domainIdqueryOptional query parameter
modequeryOptional query parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/bulk/sheet/apply

Create or update bulk sheet apply

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 2
NameInDescription
domainIdbodyJSON request field
rowsbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/bulk/sheet/google

Google-Sheets-backed modes (v1) — returns the sheet contract

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
modequeryOptional query parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/bulk/template.csv

Get bulk template.csv

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
kindqueryOptional query parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/bulk/templates

Templates & column metadata

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited