Generate Google Ads campaign brief

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaign-briefs/generate \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "platform_type": "SMART",
  "business_name": "Nordwind Furniture",
  "business_description": "Handmade oak furniture, delivered across Germany.",
  "landing_page_url": "https://example.com/spring",
  "keywords": [
    "oak furniture"
  ]
}
'

import requests

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

payload = {
    "platform_type": "SMART",
    "business_name": "Nordwind Furniture",
    "business_description": "Handmade oak furniture, delivered across Germany.",
    "landing_page_url": "https://example.com/spring",
    "keywords": ["oak furniture"]
}
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({
    platform_type: 'SMART',
    business_name: 'Nordwind Furniture',
    business_description: 'Handmade oak furniture, delivered across Germany.',
    landing_page_url: 'https://example.com/spring',
    keywords: ['oak furniture']
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaign-briefs/generate', 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/campaign-briefs/generate",
  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([
    'platform_type' => 'SMART',
    'business_name' => 'Nordwind Furniture',
    'business_description' => 'Handmade oak furniture, delivered across Germany.',
    'landing_page_url' => 'https://example.com/spring',
    'keywords' => [
        'oak furniture'
    ]
  ]),
  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/campaign-briefs/generate"

	payload := strings.NewReader("{\n  \"platform_type\": \"SMART\",\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade oak furniture, delivered across Germany.\",\n  \"landing_page_url\": \"https://example.com/spring\",\n  \"keywords\": [\n    \"oak furniture\"\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/campaign-briefs/generate")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform_type\": \"SMART\",\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade oak furniture, delivered across Germany.\",\n  \"landing_page_url\": \"https://example.com/spring\",\n  \"keywords\": [\n    \"oak furniture\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"platform_type\": \"SMART\",\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade oak furniture, delivered across Germany.\",\n  \"landing_page_url\": \"https://example.com/spring\",\n  \"keywords\": [\n    \"oak furniture\"\n  ]\n}"

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

{
  "id": "68b1c0d4e7b91d003c45a1f5",
  "platform_type": "SMART",
  "source": "user",
  "business_name": "Nordwind Furniture",
  "business_description": "Handmade oak furniture, delivered across Germany.",
  "landing_page_url": "https://example.com/spring",
  "language": "en",
  "keywords": [
    "oak furniture",
    "handmade table"
  ],
  "target_audience": "Homeowners aged 30 to 55",
  "daily_budget_micros": 15000000,
  "geo_targets": [
    "1003854"
  ],
  "headlines": [
    "Handmade oak furniture"
  ],
  "descriptions": [
    "Built to last. Delivered free."
  ],
  "schedule_type": "always",
  "schedule_days": [
    {
      "day": "MONDAY",
      "end_hour": 17,
      "start_hour": 9
    }
  ],
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z"
}

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

Campaigns

Generate Google Ads campaign brief

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

Writes a campaign brief for you from a few business details, and saves it.

Send the business name, what it does, its landing page, and any keywords you already have. Base44 writes ad headlines and descriptions from those details, and saves them as a new brief. source on the response is ai, which is how you tell a generated brief from one you wrote.

The copy is written in whichever language the details you send are in, and that language is recorded on the brief. Base44 does not open the landing page to work this out, so it passes the URL along as text and nothing more: a German site described in English produces English copy.

This runs a language model, so it is slower than the other endpoints here and it draws on a per-app quota shared with the other Google Ads generation endpoints. The default is 20 requests a minute, and your workspace’s plan can raise it, so treat the 429 rather than a fixed count as the signal you have run out.

A generation failure still returns a 200 with a saved brief. Base44 records the failure on its side and hands back a brief whose headlines and descriptions are empty, still marked source: ai. Check that those two lists are non-empty before you use the result.

This creates a new brief every time it is called. There is nothing that keeps one brief per campaign type, so a retried request leaves you with duplicates. Read the list first and use Update campaign brief when you already have one.

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

campaign-briefs

generate

Generate Google Ads campaign brief

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaign-briefs/generate \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "platform_type": "SMART",
  "business_name": "Nordwind Furniture",
  "business_description": "Handmade oak furniture, delivered across Germany.",
  "landing_page_url": "https://example.com/spring",
  "keywords": [
    "oak furniture"
  ]
}
'

import requests

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

payload = {
    "platform_type": "SMART",
    "business_name": "Nordwind Furniture",
    "business_description": "Handmade oak furniture, delivered across Germany.",
    "landing_page_url": "https://example.com/spring",
    "keywords": ["oak furniture"]
}
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({
    platform_type: 'SMART',
    business_name: 'Nordwind Furniture',
    business_description: 'Handmade oak furniture, delivered across Germany.',
    landing_page_url: 'https://example.com/spring',
    keywords: ['oak furniture']
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaign-briefs/generate', 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/campaign-briefs/generate",
  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([
    'platform_type' => 'SMART',
    'business_name' => 'Nordwind Furniture',
    'business_description' => 'Handmade oak furniture, delivered across Germany.',
    'landing_page_url' => 'https://example.com/spring',
    'keywords' => [
        'oak furniture'
    ]
  ]),
  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/campaign-briefs/generate"

	payload := strings.NewReader("{\n  \"platform_type\": \"SMART\",\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade oak furniture, delivered across Germany.\",\n  \"landing_page_url\": \"https://example.com/spring\",\n  \"keywords\": [\n    \"oak furniture\"\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/campaign-briefs/generate")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform_type\": \"SMART\",\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade oak furniture, delivered across Germany.\",\n  \"landing_page_url\": \"https://example.com/spring\",\n  \"keywords\": [\n    \"oak furniture\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"platform_type\": \"SMART\",\n  \"business_name\": \"Nordwind Furniture\",\n  \"business_description\": \"Handmade oak furniture, delivered across Germany.\",\n  \"landing_page_url\": \"https://example.com/spring\",\n  \"keywords\": [\n    \"oak furniture\"\n  ]\n}"

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

{
  "id": "68b1c0d4e7b91d003c45a1f5",
  "platform_type": "SMART",
  "source": "user",
  "business_name": "Nordwind Furniture",
  "business_description": "Handmade oak furniture, delivered across Germany.",
  "landing_page_url": "https://example.com/spring",
  "language": "en",
  "keywords": [
    "oak furniture",
    "handmade table"
  ],
  "target_audience": "Homeowners aged 30 to 55",
  "daily_budget_micros": 15000000,
  "geo_targets": [
    "1003854"
  ],
  "headlines": [
    "Handmade oak furniture"
  ],
  "descriptions": [
    "Built to last. Delivered free."
  ],
  "schedule_type": "always",
  "schedule_days": [
    {
      "day": "MONDAY",
      "end_hour": 17,
      "start_hour": 9
    }
  ],
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05: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 whose Google Ads campaigns to manage.

Body

application/json

platform_type

string

default:SMART

Which campaign type the brief is for, SMART or PERFORMANCE_MAX. Stored as sent and not checked against that list.

business_name

string

Business name to advertise.

business_description

string

What the business does. Used when Base44 generates copy.

landing_page_url

string

URL the ads will send clicks to.

keywords

string[]

Keywords the campaign should match.

Response

The generated brief, already saved.

A saved campaign brief.

Omits app_id, which the response repeats from the path.

string

required

ID of the brief. Pass this as brief_id to read, update, or delete it.

Example:

"68b1c0d4e7b91d003c45a1f5"

platform_type

string

required

Which campaign type the brief is for, SMART or PERFORMANCE_MAX.

Example:

"SMART"

source

string

required

ai when Base44 generated the brief, user when you created it.

Example:

"user"

business_name

string

required

Business name to advertise.

Example:

"Nordwind Furniture"

business_description

string

required

What the business does. Base44 uses this when it generates copy.

Example:

"Handmade oak furniture, delivered across Germany."

landing_page_url

string

required

URL the ads will send clicks to.

Example:

"https://example.com/spring"

language

string

required

Language the ad copy is written in, as a lowercase two-letter code. See the note on this field in each endpoint: create and update echo what you send, while list and get report the normalized value.

Example:

"en"

keywords

string[]

required

Keywords the campaign should match.

Example:

["oak furniture", "handmade table"]

target_audience

string

required

Free-text description of who the campaign is for. Empty when unset.

Example:

"Homeowners aged 30 to 55"

daily_budget_micros

integer

required

Planned daily budget in micros of the account currency, so 15000000 is 15.00. 0 when unset.

Example:

15000000

geo_targets

string[]

required

Google Ads geo target constant IDs to target.

Example:

["1003854"]

headlines

string[]

required

Ad headlines. Populated by generate, or by you.

Example:

["Handmade oak furniture"]

descriptions

string[]

required

Ad description lines.

Example:

["Built to last. Delivered free."]

schedule_type

string

required

always to run continuously, or custom to use schedule_days.

Example:

"always"

schedule_days

Schedule Days · object[]

required

Day and hour windows to run in, used only when schedule_type is custom.

Example:

[
  {
    "day": "MONDAY",
    "end_hour": 17,
    "start_hour": 9
  }
]

created_date

string<date-time>

required

When the brief was created.

Example:

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

updated_date

string<date-time>

required

When the brief was last changed.

Example:

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

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Generate Google Ads campaign brief

Authorizations

Path Parameters

Body

Response