Create Google Ads campaign

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "campaign_name": "Spring sale in Berlin",
  "campaign_type": "SMART",
  "daily_budget_micros": 15000000,
  "landing_page": "https://example.com/spring",
  "keyword_themes": [
    "spring sale",
    "discount furniture"
  ],
  "geo_targets": [
    "1003854"
  ]
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns"

payload = {
    "campaign_name": "Spring sale in Berlin",
    "campaign_type": "SMART",
    "daily_budget_micros": 15000000,
    "landing_page": "https://example.com/spring",
    "keyword_themes": ["spring sale", "discount furniture"],
    "geo_targets": ["1003854"]
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    campaign_name: 'Spring sale in Berlin',
    campaign_type: 'SMART',
    daily_budget_micros: 15000000,
    landing_page: 'https://example.com/spring',
    keyword_themes: ['spring sale', 'discount furniture'],
    geo_targets: ['1003854']
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'campaign_name' => 'Spring sale in Berlin',
    'campaign_type' => 'SMART',
    'daily_budget_micros' => 15000000,
    'landing_page' => 'https://example.com/spring',
    'keyword_themes' => [
        'spring sale',
        'discount furniture'
    ],
    'geo_targets' => [
        '1003854'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns"

	payload := strings.NewReader("{\n  \"campaign_name\": \"Spring sale in Berlin\",\n  \"campaign_type\": \"SMART\",\n  \"daily_budget_micros\": 15000000,\n  \"landing_page\": \"https://example.com/spring\",\n  \"keyword_themes\": [\n    \"spring sale\",\n    \"discount furniture\"\n  ],\n  \"geo_targets\": [\n    \"1003854\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign_name\": \"Spring sale in Berlin\",\n  \"campaign_type\": \"SMART\",\n  \"daily_budget_micros\": 15000000,\n  \"landing_page\": \"https://example.com/spring\",\n  \"keyword_themes\": [\n    \"spring sale\",\n    \"discount furniture\"\n  ],\n  \"geo_targets\": [\n    \"1003854\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"campaign_name\": \"Spring sale in Berlin\",\n  \"campaign_type\": \"SMART\",\n  \"daily_budget_micros\": 15000000,\n  \"landing_page\": \"https://example.com/spring\",\n  \"keyword_themes\": [\n    \"spring sale\",\n    \"discount furniture\"\n  ],\n  \"geo_targets\": [\n    \"1003854\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "68b1c0d4e7b91d003c45a1f2",
  "google_campaign_id": "21098765432",
  "campaign_name": "Spring sale in Berlin",
  "campaign_type": "SMART",
  "status": "ENABLED",
  "daily_budget_micros": 15000000,
  "landing_page": "https://example.com/spring",
  "geo_targets": [
    "1003854"
  ],
  "phone_number": "+493012345678",
  "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"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Campaigns

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

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 --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "campaign_name": "Spring sale in Berlin",
  "campaign_type": "SMART",
  "daily_budget_micros": 15000000,
  "landing_page": "https://example.com/spring",
  "keyword_themes": [
    "spring sale",
    "discount furniture"
  ],
  "geo_targets": [
    "1003854"
  ]
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns"

payload = {
    "campaign_name": "Spring sale in Berlin",
    "campaign_type": "SMART",
    "daily_budget_micros": 15000000,
    "landing_page": "https://example.com/spring",
    "keyword_themes": ["spring sale", "discount furniture"],
    "geo_targets": ["1003854"]
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    campaign_name: 'Spring sale in Berlin',
    campaign_type: 'SMART',
    daily_budget_micros: 15000000,
    landing_page: 'https://example.com/spring',
    keyword_themes: ['spring sale', 'discount furniture'],
    geo_targets: ['1003854']
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'campaign_name' => 'Spring sale in Berlin',
    'campaign_type' => 'SMART',
    'daily_budget_micros' => 15000000,
    'landing_page' => 'https://example.com/spring',
    'keyword_themes' => [
        'spring sale',
        'discount furniture'
    ],
    'geo_targets' => [
        '1003854'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns"

	payload := strings.NewReader("{\n  \"campaign_name\": \"Spring sale in Berlin\",\n  \"campaign_type\": \"SMART\",\n  \"daily_budget_micros\": 15000000,\n  \"landing_page\": \"https://example.com/spring\",\n  \"keyword_themes\": [\n    \"spring sale\",\n    \"discount furniture\"\n  ],\n  \"geo_targets\": [\n    \"1003854\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign_name\": \"Spring sale in Berlin\",\n  \"campaign_type\": \"SMART\",\n  \"daily_budget_micros\": 15000000,\n  \"landing_page\": \"https://example.com/spring\",\n  \"keyword_themes\": [\n    \"spring sale\",\n    \"discount furniture\"\n  ],\n  \"geo_targets\": [\n    \"1003854\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"campaign_name\": \"Spring sale in Berlin\",\n  \"campaign_type\": \"SMART\",\n  \"daily_budget_micros\": 15000000,\n  \"landing_page\": \"https://example.com/spring\",\n  \"keyword_themes\": [\n    \"spring sale\",\n    \"discount furniture\"\n  ],\n  \"geo_targets\": [\n    \"1003854\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "68b1c0d4e7b91d003c45a1f2",
  "google_campaign_id": "21098765432",
  "campaign_name": "Spring sale in Berlin",
  "campaign_type": "SMART",
  "status": "ENABLED",
  "daily_budget_micros": 15000000,
  "landing_page": "https://example.com/spring",
  "geo_targets": [
    "1003854"
  ],
  "phone_number": "+493012345678",
  "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"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

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:SMART

Which campaign type to create.

Available options:

SMART,

PERFORMANCE_MAX

landing_page

string

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

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 for the call extension.

contains_eu_political_advertising

boolean

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

Response

The campaign that was created.

The campaign fields this API commits to.

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 SMART and PERFORMANCE_MAX; 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:

"SMART"

status

enum<string>

required

Serving state in Base44's cache. 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: 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

Call-extension phone number, empty when the campaign has none.

Example:

"+493012345678"

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, e.g. 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. null on a campaign that has not started learning.

Example:

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

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Create Google Ads campaign

Authorizations

Path Parameters

Body

Response