Launch Google Ads campaign

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/launch \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "campaign": {
    "campaign_name": "Spring sale",
    "campaign_type": "SMART",
    "daily_budget_micros": 15000000,
    "landing_page": "https://example.com",
    "keyword_themes": [
      "oak furniture",
      "dining table"
    ],
    "business_name": "Nordwind Furniture"
  },
  "timezone": "Europe/Berlin"
}
'

import requests

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

payload = {
    "campaign": {
        "campaign_name": "Spring sale",
        "campaign_type": "SMART",
        "daily_budget_micros": 15000000,
        "landing_page": "https://example.com",
        "keyword_themes": ["oak furniture", "dining table"],
        "business_name": "Nordwind Furniture"
    },
    "timezone": "Europe/Berlin"
}
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: {
      campaign_name: 'Spring sale',
      campaign_type: 'SMART',
      daily_budget_micros: 15000000,
      landing_page: 'https://example.com',
      keyword_themes: ['oak furniture', 'dining table'],
      business_name: 'Nordwind Furniture'
    },
    timezone: 'Europe/Berlin'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/launch', 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/launch",
  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' => [
        'campaign_name' => 'Spring sale',
        'campaign_type' => 'SMART',
        'daily_budget_micros' => 15000000,
        'landing_page' => 'https://example.com',
        'keyword_themes' => [
                'oak furniture',
                'dining table'
        ],
        'business_name' => 'Nordwind Furniture'
    ],
    'timezone' => 'Europe/Berlin'
  ]),
  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/launch"

	payload := strings.NewReader("{\n  \"campaign\": {\n    \"campaign_name\": \"Spring sale\",\n    \"campaign_type\": \"SMART\",\n    \"daily_budget_micros\": 15000000,\n    \"landing_page\": \"https://example.com\",\n    \"keyword_themes\": [\n      \"oak furniture\",\n      \"dining table\"\n    ],\n    \"business_name\": \"Nordwind Furniture\"\n  },\n  \"timezone\": \"Europe/Berlin\"\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/launch")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign\": {\n    \"campaign_name\": \"Spring sale\",\n    \"campaign_type\": \"SMART\",\n    \"daily_budget_micros\": 15000000,\n    \"landing_page\": \"https://example.com\",\n    \"keyword_themes\": [\n      \"oak furniture\",\n      \"dining table\"\n    ],\n    \"business_name\": \"Nordwind Furniture\"\n  },\n  \"timezone\": \"Europe/Berlin\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": {\n    \"campaign_name\": \"Spring sale\",\n    \"campaign_type\": \"SMART\",\n    \"daily_budget_micros\": 15000000,\n    \"landing_page\": \"https://example.com\",\n    \"keyword_themes\": [\n      \"oak furniture\",\n      \"dining table\"\n    ],\n    \"business_name\": \"Nordwind Furniture\"\n  },\n  \"timezone\": \"Europe/Berlin\"\n}"

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

{
  "account": {
    "id": "68b1c0d4e7b91d003c45a1f0",
    "status": "ACTIVE",
    "account_name": "Nordwind Furniture",
    "currency_code": "EUR",
    "timezone": "Europe/Berlin",
    "google_customer_id": "1234567890"
  },
  "campaign": {
    "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>"
    }
  ]
}

Launch

Launch Google Ads campaign

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

Creates the app’s Google Ads account if it does not have one, then creates a campaign on it. This is what starts spending money.

Call Get launch readiness first and send its landing_page back here. Its currency_code is informational: there is no currency field on this request, and Base44 derives the account’s currency itself.

Creating the Google Ads account cannot be undone. There is no endpoint that deletes one, and an account keeps its currency and time zone for life. A later launch reuses that account, so the first attempt is what commits you to its currency.

A failure at the campaign step is not automatically safe to retry. Google Ads can create the campaign and then a follow-up step fail, which leaves it live and spending while Base44 has no record of it — so it does not appear in List campaigns either. The error message says when that is what happened and tells you not to re-approve. Read it before retrying.

Base44 checks what it can from the request before creating anything: a Performance Max campaign needs logo_url, the budget has to sit inside the per-currency range for the campaign type, the business name has a length limit, and targeting that can reach the EU needs an EU political-advertising declaration. Those all fail with a 400 and create nothing. Anything only Google can judge — a logo it cannot fetch, a landing page it cannot crawl — fails after the account exists.

A 409 has four different causes and they are not all safe to retry:

the workspace is on billing hold, or the account is, so no new spend is allowed. Fix the billing problem and retry.
the campaign was already launched from this draft. Retrying will not create a second one.
the request to Google Ads timed out after being sent. The campaign may be live and spending. Do not retry: read List campaigns and check before doing anything else.

The response carries the account and the campaign. A campaign can come back paused when its conversion tracking is not wired yet; Base44 enables it on its own once tracking verifies.

Launching is refused, rather than allowed through, while Base44 cannot reach its payment provider to confirm a card is on file. Get launch readiness reports that state as stripe_unavailable, so check it there instead of inferring it from a failed launch.

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

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

launch

Launch Google Ads campaign

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/launch \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "campaign": {
    "campaign_name": "Spring sale",
    "campaign_type": "SMART",
    "daily_budget_micros": 15000000,
    "landing_page": "https://example.com",
    "keyword_themes": [
      "oak furniture",
      "dining table"
    ],
    "business_name": "Nordwind Furniture"
  },
  "timezone": "Europe/Berlin"
}
'

import requests

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

payload = {
    "campaign": {
        "campaign_name": "Spring sale",
        "campaign_type": "SMART",
        "daily_budget_micros": 15000000,
        "landing_page": "https://example.com",
        "keyword_themes": ["oak furniture", "dining table"],
        "business_name": "Nordwind Furniture"
    },
    "timezone": "Europe/Berlin"
}
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: {
      campaign_name: 'Spring sale',
      campaign_type: 'SMART',
      daily_budget_micros: 15000000,
      landing_page: 'https://example.com',
      keyword_themes: ['oak furniture', 'dining table'],
      business_name: 'Nordwind Furniture'
    },
    timezone: 'Europe/Berlin'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/launch', 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/launch",
  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' => [
        'campaign_name' => 'Spring sale',
        'campaign_type' => 'SMART',
        'daily_budget_micros' => 15000000,
        'landing_page' => 'https://example.com',
        'keyword_themes' => [
                'oak furniture',
                'dining table'
        ],
        'business_name' => 'Nordwind Furniture'
    ],
    'timezone' => 'Europe/Berlin'
  ]),
  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/launch"

	payload := strings.NewReader("{\n  \"campaign\": {\n    \"campaign_name\": \"Spring sale\",\n    \"campaign_type\": \"SMART\",\n    \"daily_budget_micros\": 15000000,\n    \"landing_page\": \"https://example.com\",\n    \"keyword_themes\": [\n      \"oak furniture\",\n      \"dining table\"\n    ],\n    \"business_name\": \"Nordwind Furniture\"\n  },\n  \"timezone\": \"Europe/Berlin\"\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/launch")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign\": {\n    \"campaign_name\": \"Spring sale\",\n    \"campaign_type\": \"SMART\",\n    \"daily_budget_micros\": 15000000,\n    \"landing_page\": \"https://example.com\",\n    \"keyword_themes\": [\n      \"oak furniture\",\n      \"dining table\"\n    ],\n    \"business_name\": \"Nordwind Furniture\"\n  },\n  \"timezone\": \"Europe/Berlin\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": {\n    \"campaign_name\": \"Spring sale\",\n    \"campaign_type\": \"SMART\",\n    \"daily_budget_micros\": 15000000,\n    \"landing_page\": \"https://example.com\",\n    \"keyword_themes\": [\n      \"oak furniture\",\n      \"dining table\"\n    ],\n    \"business_name\": \"Nordwind Furniture\"\n  },\n  \"timezone\": \"Europe/Berlin\"\n}"

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

{
  "account": {
    "id": "68b1c0d4e7b91d003c45a1f0",
    "status": "ACTIVE",
    "account_name": "Nordwind Furniture",
    "currency_code": "EUR",
    "timezone": "Europe/Berlin",
    "google_customer_id": "1234567890"
  },
  "campaign": {
    "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

ID of the app to advertise.

Body

application/json

campaign

LaunchCampaignDetails · object

required

The campaign to create. Same fields as Create campaign.

Show child attributes

timezone

string

Time zone to create the Google Ads account in, as an IANA name. Only used when the account does not exist yet, and fixed for its lifetime after that. Defaults to UTC.

Response

The account the campaign lives on, and the campaign.

The account and the campaign, after both exist.

account

LaunchAccountSummary · object

required

The Google Ads account the campaign was created on, whether it already existed or was created by this call.

Show child attributes

campaign

CampaignResource · object

required

The campaign that is now live.

Show child attributes

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Launch Google Ads campaign

Authorizations

Path Parameters

Body

Response