Update ClickFlare spend push

Turns the spend push into ClickFlare on or off. When on, Koast uploads the spend of every mapped ClickFlare campaign for today every hour, and yesterday's final spend once after midnight in the ad account timezone. Each upload replaces the cost ClickFlare holds for that window. ClickFlare accepts USD only. ClickFlare must be connected and a campaign tracking field set first. Requires an organization owner or admin.

PUT

/v1/brands/{brandId}/integrations/clickflare/push

Authorization

bearerAuth

headerAuthorizationBearer <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.

Path Parameters

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

Request Body

application/json

body

enabled*boolean

Turn the hourly spend push into ClickFlare on or off for this brand.

Response Body

Update ClickFlare spend push

application/json

response

brandId*number

connected*boolean

Whether a ClickFlare API key is connected to the brand.

enabled*boolean

disabledReason*|

Why Koast turned the push off itself: unauthorized (ClickFlare rejected the key) or refused (ClickFlare refused the cost upload).

lastPushAt*string|null

lastCampaignsPushed*number

ClickFlare campaigns whose spend for today the last cycle uploaded.

lastError*string|null

lastErrorAt*string|null

unmatchedCount*number

Koast campaigns with spend and no ClickFlare campaign mapped.

schedule*

curl -X PUT "https://example.com/v1/brands/0/integrations/clickflare/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-clickflare-cost-push, see Integrations commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.