Trigger Bulk Export Job

Endpoint: POST /api/v1/analytics/exports/ This endpoint allows you to request a bulk export of users, companies, or events.

Request

  • Content-Type: application/json
  • Authorization: Token <apiKey> (optional)

Body Parameters

NameTypeDescription
fromstringStart date (ISO 8601)
tostringEnd date (ISO 8601)
emailsarrayList of emails to notify
event_typearrayEvent types to export
user_idarrayUser IDs to export
company_idarrayCompany IDs to export
segment_idstringSegment ID to export
formatstringExport file format
exclusionsstringExclusions for export

Response

  • 201 Created: Export job successfully created
  • 401 Unauthorized: Invalid API key or insufficient permissions
  • 409 Conflict: Export job already in progress

Example Response

{
  "job_id": "export:jobs:xyz789",
  "status": "pending",
  "start_time": "2024-06-01T12:00:00Z"
}