Generate Google Ads campaign brief

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

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.

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

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

{
  "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"
}