Campaigns

POST /api/v1/accounts/{projectId}/campaigns/{campaignId}/status

Propose enabling or pausing a campaign.

POST /api/v1/accounts/{projectId}/campaigns/{campaignId}/status

Propose enabling or pausing a campaign.

Money-moving and always review-tier — pausing or enabling a campaign is the largest single spend move available, so auto_apply will not change the outcome.

Requires a key with write scope or higher.

Returns 200 on success.

Parameters

NameInTypeRequiredDescription
projectIdpathstringyesThe Google Ads account, as returned by GET /api/v1/accounts.
campaignIdpathstringyesGoogle Ads campaign id, from GET /accounts/{projectId}/campaigns.

Request body

FieldTypeRequiredDescription
statusENABLED | PAUSEDyes
reasonstringyesWhy this change is being made. Shown in /approvals and /history.
auto_applybooleannoAllow the safe-apply policy to apply this change without approval if it classifies as safe. Defaults to false — the change queues in /approvals. Default: false.

Example

curl -X POST "https://bidandscale.com/api/v1/accounts/{projectId}/campaigns/{campaignId}/status" \
  -H "Authorization: Bearer $BIDANDSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ … }'

On this page