Create 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>
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.
<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>
<Note>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.</Note>
<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>
Path parameters
ID of the app whose Google Ads campaigns to manage.
ID of the app whose Google Ads campaigns to manage.
Request body
Response
Successful Response
Example response
{
"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"
}Changes
Changed in 1 of the 14 revisions of this API.1
- ○
endpoint added
endpoint-added
- ○