Stream a CSV export of all matching contacts

curl --request GET \
  --url https://your-instance.example.com/api/contacts/query-bulk-export \
  --header 'Authorization: Bearer <token>'

"First Name,Last Name,Phone,Email,Pipeline,Stage,Created Date\n\"Alex\",\"Morgan\",\"+14165550100\",\"alex.morgan@example.com\",\"Sales\",\"New Lead\",\"2026-05-20\"\n"

Contacts

Stream a CSV export of all matching contacts

Streams a CSV of every contact matching the supplied filter as text/csv with Content-Disposition: attachment; filename="contacts-YYYY-MM-DD.csv". Columns: First Name, Last Name, Phone, Email, Pipeline, Stage, Created Date. Uses a Mongo cursor so even multi-thousand exports stream incrementally without buffering. Filter semantics match the other query-* endpoints, but parameters are passed as query string: stageIds is a comma-separated list, advancedParams is a JSON-encoded string (malformed JSON is silently ignored).

GET

api

contacts

query-bulk-export

Stream a CSV export of all matching contacts

curl --request GET \
  --url https://your-instance.example.com/api/contacts/query-bulk-export \
  --header 'Authorization: Bearer <token>'

"First Name,Last Name,Phone,Email,Pipeline,Stage,Created Date\n\"Alex\",\"Morgan\",\"+14165550100\",\"alex.morgan@example.com\",\"Sales\",\"New Lead\",\"2026-05-20\"\n"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

stageIds

string

Comma-separated pipeline-stage IDs. Required unless orgWide=true.

pipelineType

enum<string>

Which model to export from. Defaults to Contact.

Available options:

Contact,

Application

orgWide

enum<string>

Set to true to export across the whole organization and ignore stageIds.

Available options:

true,

false

ownerFilter

string

Owner-based scope (owned / unowned) applied identically to the contacts list view.

advancedParams

string

JSON-encoded filter object (same shape used by the Contacts list view advanced filters). Malformed JSON is silently ignored.

Response

CSV stream

The response is of type string.

Example:

"First Name,Last Name,Phone,Email,Pipeline,Stage,Created Date\n\"Alex\",\"Morgan\",\"+14165550100\",\"alex.morgan@example.com\",\"Sales\",\"New Lead\",\"2026-05-20\"\n"

Bulk-delete all matching contacts (async)Bulk-move all matching contacts to a target pipeline stage

⌘I