---
title: "Discover Google Ads Accounts"
method: POST
path: "/admin/google-ads/discover"
tags: ["admin", "google-ads-admin"]
---

# Discover Google Ads Accounts

`POST /admin/google-ads/discover`

## Request

- Base URL: `https://api-docs.upsmith.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.upsmith.com/admin/google-ads/discover`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Walk the org's own Google Ads OAuth credential and upsert every reachable customer (and
its MCC's descendants) as an inactive candidate, returning the org's full current account
list. Never authenticates with the shared UpSmith manager credential.

## Headers

- `organization-id` string, nullable
- `timezone` string
- `x-user-id` string, nullable
- `x-actor-email` string, nullable
- `x-request-source` string, nullable
- `x-operation-id` string, nullable
- `x-commit-message` string, nullable
- `x-confirmation-id` string, nullable
- `x-chat-id` string, nullable

## Request body

- DiscoverGoogleAdsAccountsBody
  - `organization_id` string, required: organization.id (UUID) to discover standard Google Ads accounts for.

## Response `200`

Successful Response

- GoogleAdsAccountPublic[]
  - `id` string, required
  - `organization_id` string, required
  - `google_customer_id` string, required
  - `login_customer_id` string, nullable
  - `descriptive_name` string, nullable
  - `is_manager` boolean, required
  - `is_active` boolean, required
  - `currency_code` string, nullable
  - `time_zone` string, nullable
  - `auto_tagging_enabled` boolean, nullable
  - `test_account` boolean, nullable
  - `optimization_score` number, nullable
  - `last_sync_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/upsmith/apis/upsmith-api.md) - [All operations](https://skmtc.dev/upsmith/apis/upsmith-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upsmith/apis/upsmith-api/revisions/86e2c2bd93af?raw)