Campaigns
POST /api/v1/accounts/{projectId}/campaigns/{campaignId}/name
Propose renaming a campaign.
POST /api/v1/accounts/{projectId}/campaigns/{campaignId}/namePropose renaming a campaign.
Requires a key with write scope or higher.
Returns 200 on success.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | The Google Ads account, as returned by GET /api/v1/accounts. |
campaignId | path | string | yes | Google Ads campaign id, from GET /accounts/{projectId}/campaigns. |
Idempotency-Key | header | string | no | Any unique string, at most 256 characters. A retry with the same key replays the first outcome instead of doing the work twice. Keys are scoped to the endpoint. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | yes | The new name, exactly as it should read in Google Ads. |
reason | string | yes | Why this change is being made. Shown in /approvals and /history. |
auto_apply | boolean | no | Allow 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}/name" \
-H "Authorization: Bearer $BIDANDSCALE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ … }'