Skip to content

Data Exports

The Data Exports API provides programmatic access to the same Direct Data Export v2 datasets available through Studio, without requiring an SFTP connection. Instead of configuring a server-to-server file delivery, clients can use the API to discover available export files, retrieve the latest file for a given export type, and request a temporary download URL for a specific file. The API supports the same export categories used by Direct Data Export v2—users, campaigns, and activities—making it a REST-based alternative for integrating Firstup export data into external reporting, warehousing, and analytics workflows.

Operations

Get the latest export file for a given type.

Request

Returns metadata and a presigned download URL for the most recent export file of the specified type within the caller's program.

Valid type names: users, campaigns, activities.

Security
oauth2_as_a_server(Required scopes: data_exports.read) or oauth2_as_a_user(Required scopes: data_exports.read)
Path
type_namestringrequired

The export type. One of: users, campaigns, activities.

Enum:"users""campaigns""activities"
curl -i -X GET \
  'https://partner.socialchorus.com/v2/data_exports/type/{type_name}/latest' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
dataobject
Response
{
  "data": {
    "presigned_url": "string",
    "presigned_url_ttl_seconds": 900,
    "file_name": "part-00000-abc123.csv.gz",
    "size_bytes": 0,
    "checksum_function": "string",
    "checksum": "string",
    "generated_at": "2025-01-15-06"
  }
}