Create Google Ads campaign

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

Creates a campaign on the app’s Google Ads account and starts serving it.

This spends money. The workspace needs a payment method on file and an account in good standing. Without either, the call returns a 402 and no campaign is created. A campaign is also created paused when the app’s conversion tracking is not yet verified, so check status on the response rather than assuming it is serving.

Set campaign_type to PERFORMANCE_MAX. Google stopped accepting new Smart campaigns on September 23, 2026, so SMART and any other type return a 400 before anything is created. daily_budget_micros is in micros of the account currency and has a per-currency floor Google enforces. A budget below it comes back as a 400 carrying Google’s reason, and the campaign is not created. Advertisers in the EU must declare whether the campaign carries political advertising. The call is rejected until that declaration is on file.

Google validates the campaign as it is created, so a rejected ad text, an unreachable landing page, or a budget below the floor comes back as a 400 with Google’s own reason.

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.

POST /api/apps/{app_id}/google-ads/campaigns

Create Google Ads campaign

cURL

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_name": "Spring sale in Berlin",
  "campaign_type": "PERFORMANCE_MAX",
  "daily_budget_micros": 15000000,
  "landing_page": "https://example.com/spring",
  "keyword_themes": [
    "spring sale",
    "discount furniture"
  ],
  "geo_targets": [
    "1003854"
  ],
  "headlines": [
    "Oak dining tables",
    "Spring sale on now",
    "Made in Berlin"
  ],
  "descriptions": [
    "Solid oak, built to order.",
    "Free delivery across Germany this spring."
  ],
  "logo_url": "https://storage.base44.com/gads-assets/b7f3a1c8-logo.png",
  "images": [
    {
      "url": "https://storage.base44.com/gads-assets/b7f3a1c8-landscape.png",
      "field_type": "MARKETING_IMAGE"
    },
    {
      "url": "https://storage.base44.com/gads-assets/b7f3a1c8-square.png",
      "field_type": "SQUARE_MARKETING_IMAGE"
    }
  ]
}
'

200

{
  "id": "68b1c0d4e7b91d003c45a1f2",
  "google_campaign_id": "21098765432",
  "campaign_name": "Spring sale in Berlin",
  "campaign_type": "PERFORMANCE_MAX",
  "status": "ENABLED",
  "daily_budget_micros": 15000000,
  "landing_page": "https://example.com/spring",
  "geo_targets": [
    "1003854"
  ],
  "phone_number": "[phone]",
  "review_status": "REVIEWED",
  "serving_status": "SERVING",
  "primary_status": "ELIGIBLE",
  "primary_status_reasons": [
    "CAMPAIGN_BUDGET_LIMITED"
  ],
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z",
  "learning_ends_at": "2026-09-08T11:20:00Z"
}

Authorizations

Authorization · string · header · required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id · string · required

ID of the app to advertise.

Body

application/json

campaign_name · string · required

Name for the campaign.

daily_budget_micros · integer · required

Daily budget in micros of the account currency, so 15000000 is 15.00. Google enforces a per-currency minimum and rejects anything below it with a 400.

campaign_type · enum<string> · default: PERFORMANCE_MAX

Which campaign type to create.

Available options: PERFORMANCE_MAX

landing_page · string

URL the ads send clicks to. Google rejects the campaign if it cannot reach this page.

logo_url · string

URL of the logo, at least 128×128. Required for a PERFORMANCE_MAX campaign. It follows the same hosting rules as images[].url, but unlike an image a logo Base44 cannot fetch fails the request instead of being left out. A logo that is not square is padded to square.

images · object[]

Marketing images for a PERFORMANCE_MAX campaign. It needs at least one MARKETING_IMAGE and one SQUARE_MARKETING_IMAGE, and Google rejects the campaign without them.

Base44 leaves out an image it cannot fetch, rather than rejecting the request. That includes an address on another host, a file over 5 MB, and one that does not respond. If that leaves a required slot empty, Google rejects the campaign for the missing image. An address that returns something other than an image is rejected outright.

Show child attributes

sitelinks · object[]

Extra links shown under a PERFORMANCE_MAX campaign's ads, up to 20. A row with neither text nor url is dropped, a row with only one of them is rejected, and exact duplicates collapse to one. Each url needs a full domain, such as example.com.

Show child attributes

keyword_themes · string[]

Themes to match searches on.

headlines · string[]

Ad headlines. Google reviews these against its advertising policies.

descriptions · string[]

Ad description lines. Google reviews these against its advertising policies.

geo_targets · string[]

Google Ads geo target constant IDs to target.

business_name · string

Business name shown in the ad.

phone_number · string

Phone number shown in the ad, as a call asset. It must be in international format with the country code (e.g. [phone]) — Google needs the country alongside the number, and any other format is rejected with a 400. Omit for no phone.

long_headlines · string[]

Long headlines for a PERFORMANCE_MAX campaign, up to 5. Each is shortened to 90 characters without cutting a word. When you send none, the first headline is used. Google reviews these against its advertising policies.

excluded_geo_targets · string[]

Google Ads geo target constant IDs to keep the ads out of. A location can't be both targeted and excluded.

excluded_terms · string[]

Search terms the ads must not show for, up to 25, matched exactly. A comma or semicolon splits an entry into separate terms.

proximity · object

A radius around an address to serve within, instead of geo_targets. It can't be combined with geo_targets or advertise_products. With no geo_targets, the campaign counts as reaching the EU, so the request can ask for contains_eu_political_advertising. Available only when radius targeting is enabled for your account; otherwise it returns a 400.

Show child attributes

schedule_type · string · default: always

Set to custom to run the ads only in the schedule_days windows. Any other value runs them all the time.

schedule_days · object[]

When the ads run, used only when schedule_type is custom. Hours are whole hours in the Google Ads account's time zone. Google rejects the campaign for an invalid day or hour.

Show child attributes

youtube_videos · string[]

Up to 5 YouTube videos for a PERFORMANCE_MAX campaign, each a YouTube link or an 11-character video ID. To use a video file, upload it with Upload a Google Ads video and pass the ID it returns.

advertise_products · boolean · default: false

Set to true to advertise the products in the app's product feed on a PERFORMANCE_MAX campaign. The feed must be ready, and it can't be combined with proximity. Available only when product campaigns are enabled for your account; otherwise the request returns a 404.

excluded_product_ids · string[]

Product IDs from the feed that the campaign must not advertise, up to 100. They stay in the feed. Only with advertise_products.

keywords · string[] · deprecated

Deprecated and not used for targeting. Send keyword_themes.

youtube_video · string · deprecated

Deprecated. A single video, added to youtube_videos.

contains_eu_political_advertising · boolean

Whether the campaign carries political advertising. Required before an EU advertiser can create a campaign.

settings · object

Campaign settings. Only language_code is supported. Leave other keys out.

Show child attributes

Response

200

application/json

Successful Response

The campaign fields this API commits to.

id · string · required

Base44's ID for the campaign. Pass this as campaign_id on the other campaign endpoints.

Example:

"68b1c0d4e7b91d003c45a1f2"

google_campaign_id · string · required

The campaign's ID in Google Ads. Empty while a just-created campaign is still being pushed to Google.

Example:

"21098765432"

campaign_name · string · required

Name shown for the campaign.

Example:

"Spring sale in Berlin"

campaign_type · enum<string> · required

Campaign type. Base44 creates PERFORMANCE_MAX; SMART campaigns are ones it created before Google retired Smart creation on 2026-09-23. The other values appear only on campaigns created outside Base44 and synced in.

Available options: SMART, PERFORMANCE_MAX, SEARCH, DISPLAY, SHOPPING, VIDEO, DEMAND_GEN, LOCAL, UNKNOWN

Example:

"PERFORMANCE_MAX"

status · enum<string> · required

Serving state in Base44's cache. A status of REMOVED is a deleted campaign, which Google keeps for reporting.

Available options: ENABLED, PAUSED, REMOVED, UNKNOWN

Example:

"ENABLED"

daily_budget_micros · integer · required

Daily budget in micros of the account currency, where 1,000,000 micros is one unit, so 15000000 is 15.00.

Example:

15000000

landing_page · string · required

URL the ads send clicks to.

Example:

"https://example.com/spring"

geo_targets · string[] · required

Google Ads geo target constant IDs the campaign targets.

Example:

["1003854"]

phone_number · string · required

Campaign phone number in E.164, empty when the campaign has none. Both channel types store the normalized form Google holds: a call asset on PERFORMANCE_MAX, smartCampaignSettings.phone_number on SMART.

Example:

"[phone]"

review_status · string · required

Google's policy review status, passed through as Google reports it (REVIEWED, UNDER_REVIEW, …). Empty until the first sync after creation.

Example:

"REVIEWED"

serving_status · string · required

Google's serving status, passed through as Google reports it. Can still report review gating after policy review clears, so read it alongside review_status.

Example:

"SERVING"

primary_status · string · required

Google's summary of whether the campaign is serving well, passed through as Google reports it (ELIGIBLE, LIMITED, NOT_SERVING, …).

Example:

"ELIGIBLE"

primary_status_reasons · string[] · required

Google's reasons behind primary_status, for example why a campaign is limited. Empty when there is nothing to explain.

Example:

["CAMPAIGN_BUDGET_LIMITED"]

created_date · string<date-time> · required

When the campaign was created in Base44.

Example:

"2026-08-25T11:20:00Z"

updated_date · string<date-time> · required

When Base44 last changed its record of the campaign.

Example:

"2026-08-25T14:05:00Z"

learning_ends_at · string<date-time> | null

When Smart Bidding's learning period is expected to end, about 14 days after creation, or null on a campaign that has not started learning.

Example:

"2026-09-08T11:20:00Z"