Skip to main content
GET
List Google Ads campaign briefs

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.

Query Parameters

platform_type
string
default:""

Filter to SMART or PERFORMANCE_MAX

Response

The app's saved briefs, most recently changed first.

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

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:
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:
headlines
string[]
required

Ad headlines. Populated by generate, or by you.

Example:
descriptions
string[]
required

Ad description lines.

Example:
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:
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"