Get RedTrack spend push
Returns the RedTrack spend push setting of the brand and the outcome of the last push: when it ran, how many campaigns it placed, the last error and how many Koast campaigns with spend have no RedTrack campaign mapped. Any member who can access the brand can read it; changes require an organization owner or admin. disabledReason is unauthorized or refused when RedTrack refused the key, and key_changed when the brand's RedTrack key was changed (an owner or admin turns it back on).
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.
Get RedTrack spend push
application/json- response
brandId*numberconnected*booleanWhether a RedTrack API key is connected to the brand.
enabled*booleandisabledReason*|Why Koast turned the push off itself: unauthorized (RedTrack rejected the key) or refused (the RedTrack plan does not allow cost updates).
lastPushAt*string|nulllastCampaignsPushed*numberCampaigns whose spend for today the last cycle placed in RedTrack.
lastError*string|nulllastErrorAt*string|nullunmatchedCount*numberKoast campaigns with spend and no RedTrack campaign mapped.
schedule*curl -X GET "https://example.com/v1/brands/0/integrations/redtrack/push" \ -H "Authorization: Bearer koast_sk_..."{ "brandId": 0, "connected": true, "enabled": true, "disabledReason": "string", "lastPushAt": "string", "lastCampaignsPushed": 0, "lastError": "string", "lastErrorAt": "string", "unmatchedCount": 0, "schedule": { "cron": "string", "finalLocalHour": 0, "requestIntervalSeconds": 0 }}Required scope: read. CLI: koast get-redtrack-cost-push, see Integrations commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.
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.
Update RedTrack spend push
Turns the spend push into RedTrack on or off. When on, Koast places each mapped campaign's spend for today into its RedTrack campaign every hour, and yesterday's final spend once after midnight in the ad account timezone. RedTrack must be connected first. Changing the brand's RedTrack key turns the push off. Requires an organization owner or admin.