Export contacts
POST/api/partner-gateway/v1/exports/contacts
Queues an asynchronous CSV export of contacts from your account. You can scope the export in three ways: (1) provide listIds to export all contacts belonging to one or more contact lists, (2) provide contactIds to export a specific set of contacts by their IDs, or (3) omit both to export every contact in your account. The endpoint returns 202 Accepted immediately, meaning the export job has been queued but not yet completed. To track progress, poll GET /exports periodically (every 5-10 seconds is recommended). When the job finishes and isAvailableForDownload becomes true, call GET /exports/{exportId} to retrieve the time-limited download URL for the CSV file. If you need to export the same data again after the URL expires, use POST /exports/{exportId} to regenerate the export. Returns 400 if the request body is invalid (e.g. malformed list IDs or contact IDs). Returns 500 if an internal error occurs while queuing the job.
Request
Responses
- 202
- 400
- 500
Export job queued
Invalid request
Internal server error