---
title: "Create Google Ads campaign"
method: POST
path: "/api/apps/{app_id}/google-ads/campaigns"
---

# Create Google Ads campaign

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

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

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 `SMART` or `PERFORMANCE_MAX`. `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.

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

<Warning>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](/api-reference/get-google-ads-campaign) before retrying, or you can end up applying it twice.</Warning>

<Warning>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.</Warning>

## Path parameters

- `app_id` string, required — ID of the app to advertise.

## Request body

- object
  - `campaign_name` string, required — Name for the campaign.
  - `campaign_type` 'SMART' | 'PERFORMANCE_MAX' — Which campaign type to create.
  - `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.
  - `landing_page` string — URL the ads send clicks to. Google rejects the campaign if it cannot reach this page.
  - `logo_url` string — URL of a square logo image. Required for a `PERFORMANCE_MAX` campaign and rejected with a 400 when missing; ignored for `SMART`. Google must be able to fetch it.
  - `keyword_themes` string[] — Themes to match searches on, for a `SMART` campaign.
  - `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. On PERFORMANCE_MAX it becomes a call asset and must be in international format with the country code (e.g. +18506168085) — Google needs the country alongside the number, and any other format is rejected with a 400. SMART campaigns take it as typed. Omit for no phone.
  - `contains_eu_political_advertising` boolean — Whether the campaign carries political advertising. Required before an EU advertiser can create a campaign.
  - `settings` object — Campaign settings. `language_code` is the only key this API commits to; anything else is passed through undocumented.
    - `language_code` string — Two-letter code for the language the ad copy is written in, which becomes the campaign's advertising language. English when absent or unsupported — `Accept-Language` does not affect it. Pass through `settings` from [Suggest Google Ads campaigns](/api-reference/suggest-google-ads-campaigns) to keep a generated campaign's targeting on its copy's language.

## Response `200`

Successful Response

- CampaignResource — 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.
  - `google_campaign_id` string, required — The campaign's ID in Google Ads. Empty while a just-created campaign is still being pushed to Google.
  - `campaign_name` string, required — Name shown for the campaign.
  - `campaign_type` 'SMART' | 'PERFORMANCE_MAX' | 'SEARCH' | 'DISPLAY' | 'SHOPPING' | 'VIDEO' | 'DEMAND_GEN' | 'LOCAL' | 'UNKNOWN', required — Campaign type. Base44 creates `SMART` and `PERFORMANCE_MAX`. The other values appear only on campaigns created outside Base44 and synced in.
  - `status` 'ENABLED' | 'PAUSED' | 'REMOVED' | 'UNKNOWN', required — Serving state in Base44's cache. A status of `REMOVED` is a deleted campaign, which Google keeps for reporting.
  - `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.
  - `landing_page` string, required — URL the ads send clicks to.
  - `geo_targets` string[], required — Google Ads geo target constant IDs the campaign targets.
  - `phone_number` string, required — Campaign phone number, empty when the campaign has none. E.164 on PERFORMANCE_MAX (where it is a call asset); as typed on SMART.
  - `learning_ends_at` string, date-time, nullable — 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.
  - `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.
  - `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`.
  - `primary_status` string, required — Google's summary of whether the campaign is serving well, passed through as Google reports it (`ELIGIBLE`, `LIMITED`, `NOT_SERVING`, …).
  - `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.
  - `created_date` string, date-time, required — When the campaign was created in Base44.
  - `updated_date` string, date-time, required — When Base44 last changed its record of the campaign.

## Other responses

- `400` — Google Ads rejected the request, for example ad text that breaks its policies or a budget below the currency's minimum. The response message carries Google's reason.
- `401` — Missing or invalid credentials.
- `402` — No payment method on file, or the workspace has an unpaid balance.
- `403` — You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `404` — The app has no connected Google Ads account, or there is no campaign with this ID.
- `409` — The request to Google Ads timed out after being sent, so the change may or may not have been applied. Read the campaign back before retrying.
- `422` — Validation Error
- `429` — Google Ads is rate limiting the account. Retry later.

## Changes

- **2026-08-26** `f2727732ced1` — 2 info
  - added the new optional request property `logo_url`
  - added the new optional request property `settings`
- **2026-08-26** `df72f6cff1ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/campaigns/post.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/d8572ad3094a/schema)