Launch Google Ads campaign
curl --request POST \
--url https://app.base44.com/api/apps/{app_id}/google-ads/launch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"campaign": {
"campaign_name": "Spring sale",
"campaign_type": "PERFORMANCE_MAX",
"daily_budget_micros": 15000000,
"landing_page": "https://example.com",
"business_name": "Nordwind Furniture",
"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"
}
],
"sitelinks": [
{
"text": "Visit our showroom",
"url": "https://example.com/showroom"
}
]
},
"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": "PERFORMANCE_MAX",
"daily_budget_micros": 15000000,
"landing_page": "https://example.com",
"business_name": "Nordwind Furniture",
"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"
}
],
"sitelinks": [
{
"text": "Visit our showroom",
"url": "https://example.com/showroom"
}
]
},
"timezone": "Europe/Berlin"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
campaign: {
campaign_name: 'Spring sale',
campaign_type: 'PERFORMANCE_MAX',
daily_budget_micros: 15000000,
landing_page: 'https://example.com',
business_name: 'Nordwind Furniture',
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'
}
],
sitelinks: [{text: 'Visit our showroom', url: 'https://example.com/showroom'}]
},
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' => 'PERFORMANCE_MAX',
'daily_budget_micros' => 15000000,
'landing_page' => 'https://example.com',
'business_name' => 'Nordwind Furniture',
'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'
]
],
'sitelinks' => [
[
'text' => 'Visit our showroom',
'url' => 'https://example.com/showroom'
]
]
],
'timezone' => 'Europe/Berlin'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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\": \"PERFORMANCE_MAX\",\n \"daily_budget_micros\": 15000000,\n \"landing_page\": \"https://example.com\",\n \"business_name\": \"Nordwind Furniture\",\n \"headlines\": [\n \"Oak dining tables\",\n \"Spring sale on now\",\n \"Made in Berlin\"\n ],\n \"descriptions\": [\n \"Solid oak, built to order.\",\n \"Free delivery across Germany this spring.\"\n ],\n \"logo_url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-logo.png\",\n \"images\": [\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-landscape.png\",\n \"field_type\": \"MARKETING_IMAGE\"\n },\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-square.png\",\n \"field_type\": \"SQUARE_MARKETING_IMAGE\"\n }\n ],\n \"sitelinks\": [\n {\n \"text\": \"Visit our showroom\",\n \"url\": \"https://example.com/showroom\"\n }\n ]\n },\n \"timezone\": \"Europe/Berlin\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"campaign\": {\n \"campaign_name\": \"Spring sale\",\n \"campaign_type\": \"PERFORMANCE_MAX\",\n \"daily_budget_micros\": 15000000,\n \"landing_page\": \"https://example.com\",\n \"business_name\": \"Nordwind Furniture\",\n \"headlines\": [\n \"Oak dining tables\",\n \"Spring sale on now\",\n \"Made in Berlin\"\n ],\n \"descriptions\": [\n \"Solid oak, built to order.\",\n \"Free delivery across Germany this spring.\"\n ],\n \"logo_url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-logo.png\",\n \"images\": [\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-landscape.png\",\n \"field_type\": \"MARKETING_IMAGE\"\n },\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-square.png\",\n \"field_type\": \"SQUARE_MARKETING_IMAGE\"\n }\n ],\n \"sitelinks\": [\n {\n \"text\": \"Visit our showroom\",\n \"url\": \"https://example.com/showroom\"\n }\n ]\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["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"campaign\": {\n \"campaign_name\": \"Spring sale\",\n \"campaign_type\": \"PERFORMANCE_MAX\",\n \"daily_budget_micros\": 15000000,\n \"landing_page\": \"https://example.com\",\n \"business_name\": \"Nordwind Furniture\",\n \"headlines\": [\n \"Oak dining tables\",\n \"Spring sale on now\",\n \"Made in Berlin\"\n ],\n \"descriptions\": [\n \"Solid oak, built to order.\",\n \"Free delivery across Germany this spring.\"\n ],\n \"logo_url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-logo.png\",\n \"images\": [\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-landscape.png\",\n \"field_type\": \"MARKETING_IMAGE\"\n },\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-square.png\",\n \"field_type\": \"SQUARE_MARKETING_IMAGE\"\n }\n ],\n \"sitelinks\": [\n {\n \"text\": \"Visit our showroom\",\n \"url\": \"https://example.com/showroom\"\n }\n ]\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": "PERFORMANCE_MAX",
"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 these from the request before creating anything, and a request that fails one creates nothing:
- A Performance Max campaign has a
logo_url, plus at least oneMARKETING_IMAGEand oneSQUARE_MARKETING_IMAGEwhoseurlis on a host Base44 fetches images from. - The budget sits inside the per-currency range for the campaign type.
- The business name is within its length limit.
sitelinksandphone_numberare well formed.- Targeting that can reach the EU carries a political-advertising declaration.
Anything Base44 only finds out by fetching, or that only Google can judge, fails after the account exists. That includes an image or logo that doesn’t download and a landing page Google can’t crawl.
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 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"campaign": {
"campaign_name": "Spring sale",
"campaign_type": "PERFORMANCE_MAX",
"daily_budget_micros": 15000000,
"landing_page": "https://example.com",
"business_name": "Nordwind Furniture",
"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"
}
],
"sitelinks": [
{
"text": "Visit our showroom",
"url": "https://example.com/showroom"
}
]
},
"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": "PERFORMANCE_MAX",
"daily_budget_micros": 15000000,
"landing_page": "https://example.com",
"business_name": "Nordwind Furniture",
"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"
}
],
"sitelinks": [
{
"text": "Visit our showroom",
"url": "https://example.com/showroom"
}
]
},
"timezone": "Europe/Berlin"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
campaign: {
campaign_name: 'Spring sale',
campaign_type: 'PERFORMANCE_MAX',
daily_budget_micros: 15000000,
landing_page: 'https://example.com',
business_name: 'Nordwind Furniture',
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'
}
],
sitelinks: [{text: 'Visit our showroom', url: 'https://example.com/showroom'}]
},
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' => 'PERFORMANCE_MAX',
'daily_budget_micros' => 15000000,
'landing_page' => 'https://example.com',
'business_name' => 'Nordwind Furniture',
'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'
]
],
'sitelinks' => [
[
'text' => 'Visit our showroom',
'url' => 'https://example.com/showroom'
]
]
],
'timezone' => 'Europe/Berlin'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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\": \"PERFORMANCE_MAX\",\n \"daily_budget_micros\": 15000000,\n \"landing_page\": \"https://example.com\",\n \"business_name\": \"Nordwind Furniture\",\n \"headlines\": [\n \"Oak dining tables\",\n \"Spring sale on now\",\n \"Made in Berlin\"\n ],\n \"descriptions\": [\n \"Solid oak, built to order.\",\n \"Free delivery across Germany this spring.\"\n ],\n \"logo_url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-logo.png\",\n \"images\": [\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-landscape.png\",\n \"field_type\": \"MARKETING_IMAGE\"\n },\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-square.png\",\n \"field_type\": \"SQUARE_MARKETING_IMAGE\"\n }\n ],\n \"sitelinks\": [\n {\n \"text\": \"Visit our showroom\",\n \"url\": \"https://example.com/showroom\"\n }\n ]\n },\n \"timezone\": \"Europe/Berlin\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"campaign\": {\n \"campaign_name\": \"Spring sale\",\n \"campaign_type\": \"PERFORMANCE_MAX\",\n \"daily_budget_micros\": 15000000,\n \"landing_page\": \"https://example.com\",\n \"business_name\": \"Nordwind Furniture\",\n \"headlines\": [\n \"Oak dining tables\",\n \"Spring sale on now\",\n \"Made in Berlin\"\n ],\n \"descriptions\": [\n \"Solid oak, built to order.\",\n \"Free delivery across Germany this spring.\"\n ],\n \"logo_url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-logo.png\",\n \"images\": [\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-landscape.png\",\n \"field_type\": \"MARKETING_IMAGE\"\n },\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-square.png\",\n \"field_type\": \"SQUARE_MARKETING_IMAGE\"\n }\n ],\n \"sitelinks\": [\n {\n \"text\": \"Visit our showroom\",\n \"url\": \"https://example.com/showroom\"\n }\n ]\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["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"campaign\": {\n \"campaign_name\": \"Spring sale\",\n \"campaign_type\": \"PERFORMANCE_MAX\",\n \"daily_budget_micros\": 15000000,\n \"landing_page\": \"https://example.com\",\n \"business_name\": \"Nordwind Furniture\",\n \"headlines\": [\n \"Oak dining tables\",\n \"Spring sale on now\",\n \"Made in Berlin\"\n ],\n \"descriptions\": [\n \"Solid oak, built to order.\",\n \"Free delivery across Germany this spring.\"\n ],\n \"logo_url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-logo.png\",\n \"images\": [\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-landscape.png\",\n \"field_type\": \"MARKETING_IMAGE\"\n },\n {\n \"url\": \"https://storage.base44.com/gads-assets/b7f3a1c8-square.png\",\n \"field_type\": \"SQUARE_MARKETING_IMAGE\"\n }\n ],\n \"sitelinks\": [\n {\n \"text\": \"Visit our showroom\",\n \"url\": \"https://example.com/showroom\"\n }\n ]\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": "PERFORMANCE_MAX",
"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
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
ID of the app to advertise.
Body
application/json
The campaign to create. Same fields as Create campaign.
Show child attributes
Show child attributes
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.
Was this page helpful?