Update Google Ads campaign

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Changes one section of a campaign and pushes it to Google.

Send the section in field and its new value in value. One section per request. To change a name and a budget, send two requests.

Changing ad_copy sends the new text back through Google’s policy review, so the campaign can return to a reviewing state and stop serving until it clears. Changing budget takes effect for the rest of the current day.

Google validates the change, so text that breaks its policies or a budget below the currency’s floor comes back as a 400 with Google’s reason and the campaign is left as it was. To change the budget on several campaigns at once, use Update campaign budgets in bulk.

The response carries id plus only the section you changed, not the whole campaign. Read the campaign back with Get campaign when you need its full state.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

A 409 means the change may or may not have been applied. The request to Google Ads timed out after it was sent. Read the campaign back with Get campaign before retrying, or you can end up applying it twice.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time. Send only the fields documented here. Other request fields are not supported and their behavior can change.

PATCH /api/apps/{app_id}/google-ads/campaigns/{campaign_id}

cURL

rename

curl --request PATCH \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id} \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "field": "name",
  "value": "Spring sale in Berlin"
}
'

200

{
  "id": "68b1c0d4e7b91d003c45a1f2",
  "campaign_name": "Spring sale in Berlin",
  "daily_budget_micros": 15000000
}

Authorizations

api_key · string · header · required

Personal API key.

Path Parameters

app_id · string · required

ID of the app whose Google Ads campaigns to manage.

campaign_id · string · required

Base44's ID for the campaign, as returned in id by List campaigns. This is not the Google Ads campaign ID, which is reported separately as google_campaign_id.

Body

application/json

field · enum<string> · required

Which part of the campaign to change. One section per request.

Available options: name, budget, details, ad_copy, targeting, images, asset

value · any · required

The new value, shaped by field. A name takes a string, budget takes the daily budget in micros as a number, and ad_copy takes an object with any of headlines, descriptions, long_headlines, and business_name. The targeting, details, images, and asset fields take an object whose shape follows that section of the campaign.

Response

200

application/json

Successful Response

What an update returns, the campaign ID plus only the section that changed.

id · string | null

Base44's ID for the campaign. Absent when you changed images, which reports updated_field_types instead.

Example:

"68b1c0d4e7b91d003c45a1f2"

campaign_name · string | null

Present when you changed name.

Example:

"Spring sale in Berlin"

daily_budget_micros · integer | null

Present when you changed budget.

Example:

15000000