Skip to main content
GET
Reports API
Retrieve download links for your campaign reports without logging into the Connectly UI. Each response contains a signed URL pointing to the same CSV you would download manually β€” making it easy to automate ingestion into a data warehouse or BI tool.

Endpoint

Query parameters

string
Filter results to a specific report type (e.g. campaign.daily.v1). If omitted, all configured report types are returned.

How it works

This endpoint returns the most recent completed run of each report configured for your business. Reports are generated on a fixed schedule (daily, monthly, etc.) β€” there is no way to trigger a new run on demand via the API.
The url in each result is a signed, temporary link that expires after the report’s configured TTL (1 hour by default). Always check the expiresAt field and download the file before then. If the URL has expired, call this endpoint again to get a fresh one from the next completed run β€” or subscribe to report webhooks to be notified the moment each new run completes.

Example

Response fields

Downloading the CSV

Once you have the signed URL from result.url, perform a standard HTTP GET to download the file. For the column reference, see Campaign report.
Subscribe to report webhooks to receive an immediate notification β€” including a fresh signed URL β€” the moment a new report run completes, rather than polling this endpoint on a schedule.