> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Google Ads campaign briefs
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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.
This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.
The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/google-ads/campaign-briefs
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- ApiKeyAuth: []
paths:
/api/apps/{app_id}/google-ads/campaign-briefs:
get:
summary: List Google Ads campaign briefs
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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.
This endpoint accepts a personal API key. Workspace API keys are
not authorized for it and are rejected with a 403.
The response includes fields beyond the ones documented here.
Don't rely on undocumented response fields, as they can change at any
time.
operationId: list_campaign_briefs_api_apps__app_id__google_ads_campaign_briefs_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app whose Google Ads campaigns to manage.
title: App Id
description: ID of the app whose Google Ads campaigns to manage.
example: 6820f3a4e7b91d003c45a1f2
- name: platform_type
in: query
required: false
schema:
type: string
description: Filter to SMART or PERFORMANCE_MAX
default: ''
title: Platform Type
description: Filter to SMART or PERFORMANCE_MAX
responses:
'200':
description: The app's saved briefs, most recently changed first.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CampaignBriefResource'
title: >-
Response 200 List Campaign Briefs Api Apps App Id Google Ads
Campaign Briefs Get
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have access to this app, the app does not exist, or you
used a workspace API key. A missing app and an app you cannot reach
are deliberately the same answer.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
CampaignBriefResource:
properties:
id:
type: string
title: Id
description: >-
ID of the brief. Pass this as `brief_id` to read, update, or delete
it.
example: 68b1c0d4e7b91d003c45a1f5
platform_type:
type: string
title: Platform Type
description: Which campaign type the brief is for, `SMART` or `PERFORMANCE_MAX`.
example: SMART
source:
type: string
title: Source
description: '`ai` when Base44 generated the brief, `user` when you created it.'
example: user
business_name:
type: string
title: Business Name
description: Business name to advertise.
example: Nordwind Furniture
business_description:
type: string
title: Business Description
description: What the business does. Base44 uses this when it generates copy.
example: Handmade oak furniture, delivered across Germany.
landing_page_url:
type: string
title: Landing Page Url
description: URL the ads will send clicks to.
example: https://example.com/spring
language:
type: string
title: Language
description: >-
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:
items:
type: string
type: array
title: Keywords
description: Keywords the campaign should match.
example:
- oak furniture
- handmade table
target_audience:
type: string
title: Target Audience
description: Free-text description of who the campaign is for. Empty when unset.
example: Homeowners aged 30 to 55
daily_budget_micros:
type: integer
title: Daily Budget Micros
description: >-
Planned daily budget in micros of the account currency, so
`15000000` is 15.00. `0` when unset.
example: 15000000
geo_targets:
items:
type: string
type: array
title: Geo Targets
description: Google Ads geo target constant IDs to target.
example:
- '1003854'
headlines:
items:
type: string
type: array
title: Headlines
description: Ad headlines. Populated by generate, or by you.
example:
- Handmade oak furniture
descriptions:
items:
type: string
type: array
title: Descriptions
description: Ad description lines.
example:
- Built to last. Delivered free.
schedule_type:
type: string
title: Schedule Type
description: '`always` to run continuously, or `custom` to use `schedule_days`.'
example: always
schedule_days:
items:
additionalProperties: true
type: object
type: array
title: Schedule Days
description: >-
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:
type: string
format: date-time
title: Created Date
description: When the brief was created.
example: '2026-08-25T11:20:00Z'
updated_date:
type: string
format: date-time
title: Updated Date
description: When the brief was last changed.
example: '2026-08-25T14:05:00Z'
type: object
required:
- id
- platform_type
- source
- business_name
- business_description
- landing_page_url
- language
- keywords
- target_audience
- daily_budget_micros
- geo_targets
- headlines
- descriptions
- schedule_type
- schedule_days
- created_date
- updated_date
title: CampaignBriefResource
description: |-
A saved campaign brief.
Omits `app_id`, which the response repeats from the path.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````