Create Google Ads campaign brief

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

Saves a new campaign brief.

A campaign brief is saved input for a campaign you have not launched yet: the business details, the keywords, the budget you have in mind, and the ad copy. Base44 stores it so you can build a campaign over several requests instead of one, and nothing about a brief reaches Google Ads until you create a campaign from it.

Every field is optional, so you can save a partial brief and fill it in later with Update campaign brief. Set platform_type to SMART or PERFORMANCE_MAX. It is stored as sent and is not checked against that list.

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 language you send is stored as-is and echoed back here. List campaign briefs and Get campaign brief report it normalized instead. A regional code is reduced to its primary subtag, so pt-BR reads back as pt, and a code Google Ads does not support reads back as en. Send a plain two-letter code to get the same value from every endpoint.

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

Create Google Ads campaign brief

cURL

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaign-briefs \
  --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",
  "language": "de",
  "keywords": [
    "oak furniture",
    "handmade table"
  ],
  "daily_budget_micros": 15000000,
  "geo_targets": [
    "1003854"
  ]
}
'

200

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

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.

language · string · default: en

Language the ad copy is in, as a lowercase two-letter code such as en or de.

keywords · string[]

Keywords the campaign should match.

target_audience · string

Free-text description of who the campaign is for.

daily_budget_micros · integer

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

geo_targets · string[]

Google Ads geo target constant IDs to target.

headlines · string[]

Ad headlines.

descriptions · string[]

Ad description lines.

schedule_type · string · default: always

When the campaign runs. Use always to run continuously, or custom to use schedule_days.

schedule_days · object[]

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

Show child attributes

Response

200

application/json

Successful Response

A saved campaign brief.

id · 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

Who wrote the brief. The value is ai when Base44 generated it and 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. The value is 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

When the campaign runs. Use 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"