Access & Authentication

our data is stored in a Google Cloud Storage bucket. You will be provided with a GCP service account that has read-only access scoped to your organisation's folder within the bucket.

GCP Bucket Structure

<your-organisation>/exports/<date>/

Each day's data is stored in a date-stamped folder using YYYY-MM-DD format. For example:

acme/exports/2026-02-15/
acme/exports/2026-02-16/
acme/exports/2026-02-17/

Authenticating with Google Cloud

Use the service account credentials (JSON key file) provided by your account manager. These credentials can be used with:

The Google Cloud SDK (gsutil command-line tool)
Any GCS-compatible client library (Python, Node.js, Java, etc.)
The Google Cloud Console (web UI)

Example:

# Authenticate
gcloud auth activate-service-account --key-file=your-credentials.json

# Download a file
gcloud storage cp gs://flexms/<your-org-name>/exports/2026-02-02/campaigns.csv ./

Service Account Permissions

Please note that the service account does not permit listing files in the Google Cloud Bucket. You must fetch files based on the conventions noted in this document. If an error occurs, its because the file does not exist.