List RedTrack campaign mappings
Returns the campaign mappings used by the RedTrack spend push: automatic ones derived from the RedTrack clicks of the last days (sub3, falling back to rt_campaign_id), manual ones, the Koast campaigns with spend that have no mapping (with the reason), and the RedTrack campaigns to pick from. Any member who can access the brand can read it; changes require an organization owner or admin.
bearerAuthAuthorizationBearer <token>An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.
brandId*integerThe brand the request acts on. Every brand-scoped resource lives under its brand.
List RedTrack campaign mappings
application/json- response
brandId*numbermappings*array<>unmatched*array<>redtrackCampaigns*array<>curl -X GET "https://example.com/v1/brands/0/integrations/redtrack/mappings" \ -H "Authorization: Bearer koast_sk_..."{ "brandId": 0, "mappings": [ { "providerCampaignId": "string", "koastCampaignName": "string", "provider": "string", "rtCampaignId": "string", "rtCampaignName": "string", "source": "auto", "matchedOn": "sub3", "pushable": true, "skipReason": "shared_campaign_without_sub3", "updatedAt": "string", "updatedByUserId": 0 } ], "unmatched": [ { "providerCampaignId": "string", "koastCampaignName": "string", "provider": "string", "reason": "ambiguous", "candidates": [ { "rtCampaignId": "string", "rtCampaignName": "string", "clicks": 0 } ] } ], "redtrackCampaigns": [ { "id": "string", "title": "string", "autoCostUpdate": true } ]}Required scope: read. CLI: koast list-redtrack-campaign-mappings, see Integrations commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.
Update ClickFlare settings
Changes the ClickFlare workspaces Koast reads and overrides the tracking fields that carry the ad platform campaign, ad set and ad ids. Only the fields sent change. A tracking field set here is marked manual and is never replaced by detection; null clears it. Requires an organization owner or admin.
Update RedTrack campaign mapping
Sets the RedTrack campaign that receives the spend of an ad platform campaign. A manual mapping wins over the automatic one. Send rtCampaignId: null to remove the manual mapping. Returns the full mapping list. Requires an organization owner or admin.