Get Google Ads campaign brief

Changed on

<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>

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

Path parameters

app_idstring required

ID of the app whose Google Ads campaigns to manage.

brief_idstring required

ID of the brief, as returned in id by List campaign briefs.

Response

Successful Response

idstring required

ID of the brief. Pass this as brief_id to read, update, or delete it.

platform_typestring required

Which campaign type the brief is for, SMART or PERFORMANCE_MAX.

sourcestring required

Who wrote the brief. The value is ai when Base44 generated it and user when you created it.

business_namestring required

Business name to advertise.

business_descriptionstring required

What the business does. Base44 uses this when it generates copy.

landing_page_urlstring required

URL the ads will send clicks to.

languagestring 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.

keywordsstring[] required

Keywords the campaign should match.

target_audiencestring required

Free-text description of who the campaign is for. Empty when unset.

daily_budget_microsinteger required

Planned daily budget in micros of the account currency, so 15000000 is 15.00. The value is 0 when unset.

geo_targetsstring[] required

Google Ads geo target constant IDs to target.

headlinesstring[] required

Ad headlines. Populated by generate, or by you.

descriptionsstring[] required

Ad description lines.

schedule_typestring required

When the campaign runs. Use always to run continuously, or custom to use schedule_days.

schedule_daysobject[] required

Day and hour windows to run in, used only when schedule_type is custom.

created_datestring date-time required

When the brief was created.

updated_datestring date-time required

When the brief was last changed.

Example response

{
  "id": "68b1c0d4e7b91d003c45a1f5",
  "platform_type": "PERFORMANCE_MAX",
  "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

  • b92cc2f13639Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 5e139db2e643Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API