List Google Ads campaign briefs
Returns the app’s saved campaign briefs, most recently changed first.
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.
Pass platform_type to return only the briefs for one campaign type. Any other value returns an empty list rather than an error, so check the value you send.
Authorizations
Personal API key.
Path Parameters
ID of the app whose Google Ads campaigns to manage.
Query Parameters
Filter to SMART or PERFORMANCE_MAX
Response
The app's saved briefs, most recently changed first.
ID of the brief. Pass this as brief_id to read, update, or delete it.
"68b1c0d4e7b91d003c45a1f5"
Which campaign type the brief is for, SMART or PERFORMANCE_MAX.
"SMART"
ai when Base44 generated the brief, user when you created it.
"user"
Business name to advertise.
"Nordwind Furniture"
What the business does. Base44 uses this when it generates copy.
"Handmade oak furniture, delivered across Germany."
URL the ads will send clicks to.
"https://example.com/spring"
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.
"en"
Keywords the campaign should match.
Free-text description of who the campaign is for. Empty when unset.
"Homeowners aged 30 to 55"
Planned daily budget in micros of the account currency, so 15000000 is 15.00. 0 when unset.
15000000
Google Ads geo target constant IDs to target.
Ad headlines. Populated by generate, or by you.
Ad description lines.
always to run continuously, or custom to use schedule_days.
"always"
Day and hour windows to run in, used only when schedule_type is custom.
When the brief was created.
"2026-08-25T11:20:00Z"
When the brief was last changed.
"2026-08-25T14:05:00Z"