{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-Docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Quickstart: Campaign Manager (v2)","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"quickstart-campaign-manager-v2","__idx":0},"children":["Quickstart: Campaign Manager (v2)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This walkthrough lists your campaigns and downloads a basic CSV report for one of them, using the v2 Campaign Manager API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For credentials, the OAuth flow, error handling, and rate limits, see ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/getting-started"},"children":["Getting Started"]}]},". This page assumes you already have a valid access token."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Starting fresh?"]}," New integrations should prefer the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/quickstart-distributions"},"children":["Distribution Manager (v3) Quickstart"]}]},". v2 remains fully supported, but v3 reflects current naming and is the long-term API surface."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-list-your-campaigns","__idx":1},"children":["1. List your campaigns"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n  --url [Your API Base URL]/v2/campaign-manager/campaigns \\\n  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful response looks like this:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"pageNumber\": 1,\n  \"pageSize\": 20,\n  \"totalItems\": 1,\n  \"data\": [\n    {\n      \"id\": \"1a2b3c4d-e5f6-7890-1234-567890abcdef\",\n      \"name\": \"Your Campaign Name\",\n      \"businessEntity\": \"Talli\"\n      // ... other campaign fields\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," of the campaign you want to report on."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-download-a-basic-campaign-report-csv","__idx":2},"children":["2. Download a basic campaign report (CSV)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the campaign ID from step 1. Note the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept: text/csv"]}," header and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--output"]}," flag to save the file:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n  --url '[Your API Base URL]/v2/campaign-manager/reports/campaigns/YOUR_CAMPAIGN_ID/basic?pageNumber=1&pageSize=1000' \\\n  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \\\n  --header 'Accept: text/csv' \\\n  --output campaign_report.csv\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_CAMPAIGN_ID"]}," with the ID you copied."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This saves a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["campaign_report.csv"]}," file in your current directory."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":3},"children":["Next steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full set of v2 endpoints — payout instructions, bank accounts, transfers, templates, reports, and more — see the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Campaign Manager v2"]}," API Reference in the sidebar."]}]},"headings":[{"value":"Quickstart: Campaign Manager (v2)","id":"quickstart-campaign-manager-v2","depth":1},{"value":"1. List your campaigns","id":"1-list-your-campaigns","depth":2},{"value":"2. Download a basic campaign report (CSV)","id":"2-download-a-basic-campaign-report-csv","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Quickstart: Campaign Manager (v2)"}},"lastModified":"2026-05-07T09:00:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/quickstart-campaigns","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}