---
title: "Get Google Ads campaign brief"
method: GET
path: "/api/apps/{app_id}/google-ads/campaign-briefs/{brief_id}"
---

# Get Google Ads campaign brief

`GET /api/apps/{app_id}/google-ads/campaign-briefs/{brief_id}`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/google-ads/campaign-briefs/{brief_id}`
- Auth: HTTP bearer

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

Returns one saved campaign brief.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</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.</Warning>

## Path parameters

- `app_id` string, required: ID of the app whose Google Ads campaigns to manage.
- `brief_id` string, required: ID of the brief, as returned in `id` by [List campaign briefs](/api-reference/list-google-ads-campaign-briefs).

## Response `200`

Successful Response

- CampaignBriefResource: A saved campaign brief.
  - `id` string, required: ID of the brief. Pass this as `brief_id` to read, update, or delete it.
  - `platform_type` string, required: Which campaign type the brief is for, `SMART` or `PERFORMANCE_MAX`.
  - `source` string, required: Who wrote the brief. The value is `ai` when Base44 generated it and `user` when you created it.
  - `business_name` string, required: Business name to advertise.
  - `business_description` string, required: What the business does. Base44 uses this when it generates copy.
  - `landing_page_url` string, required: URL the ads will send clicks to.
  - `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.
  - `keywords` string[], required: Keywords the campaign should match.
  - `target_audience` string, required: Free-text description of who the campaign is for. Empty when unset.
  - `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.
  - `geo_targets` string[], required: Google Ads geo target constant IDs to target.
  - `headlines` string[], required: Ad headlines. Populated by generate, or by you.
  - `descriptions` string[], required: Ad description lines.
  - `schedule_type` string, required: When the campaign runs. Use `always` to run continuously, or `custom` to use `schedule_days`.
  - `schedule_days` object[], required: Day and hour windows to run in, used only when `schedule_type` is `custom`.
  - `created_date` string, date-time, required: When the brief was created.
  - `updated_date` string, date-time, required: When the brief was last changed.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: 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. Marketing setup, campaign edits, generation and resuming also return `app_marketing_not_allowed` when the app's owning workspace has the FERPA designation. Historical reads, pausing, deletion and financial settlement remain available.
- `404`: There is no brief with this ID on this app.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-13** `b92cc2f13639`: 2 info
  - the security scope `read_only` was added to the endpoint's security scheme `PersonalAccessTokenAuth`
  - the security scope `full_access` was removed from the endpoint's security scheme `PersonalAccessTokenAuth`
- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/campaign-briefs/:brief_id/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)