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.
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.
application/json- body
enabled*booleanTurn the hourly spend push into RedTrack on or off for this brand.
Update 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 PUT "https://example.com/v1/brands/0/integrations/redtrack/push" \ -H "Authorization: Bearer koast_sk_..." \ -H "Content-Type: application/json" \ -d '{ "enabled": true }'{ "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: write. CLI: koast update-redtrack-cost-push, see Integrations commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.
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).
List Koast batches
Lists the brand's Koast launches (batches), drafts and published, with their status and campaign, ad set and ad counts. Filter by status or by a title substring with search.