Skip to content
Last updated

Quickstart: Campaign Manager (v2)

This walkthrough lists your campaigns and downloads a basic CSV report for one of them, using the v2 Campaign Manager API.

For credentials, the OAuth flow, error handling, and rate limits, see Getting Started. This page assumes you already have a valid access token.

Starting fresh? New integrations should prefer the Distribution Manager (v3) Quickstart. v2 remains fully supported, but v3 reflects current naming and is the long-term API surface.

1. List your campaigns

curl --request GET \
  --url [Your API Base URL]/v2/campaign-manager/campaigns \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

A successful response looks like this:

{
  "pageNumber": 1,
  "pageSize": 20,
  "totalItems": 1,
  "data": [
    {
      "id": "1a2b3c4d-e5f6-7890-1234-567890abcdef",
      "name": "Your Campaign Name",
      "businessEntity": "Talli"
      // ... other campaign fields
    }
  ]
}

Copy the id of the campaign you want to report on.

2. Download a basic campaign report (CSV)

Use the campaign ID from step 1. Note the Accept: text/csv header and the --output flag to save the file:

curl --request GET \
  --url '[Your API Base URL]/v2/campaign-manager/reports/campaigns/YOUR_CAMPAIGN_ID/basic?pageNumber=1&pageSize=1000' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Accept: text/csv' \
  --output campaign_report.csv

Replace YOUR_CAMPAIGN_ID with the ID you copied.

This saves a campaign_report.csv file in your current directory.

Next steps

For the full set of v2 endpoints — payout instructions, bank accounts, transfers, templates, reports, and more — see the Campaign Manager v2 API Reference in the sidebar.

Previous page