Tools for discovering Google Ads customer accounts accessible to the authenticated team.
Start Here
Call list_ad_accounts first to discover available customer IDs. The returned IDs are required by every other tool (list_campaigns, list_ad_groups, list_ads, get_insights).
list_ad_accounts
List Google Ads customers accessible to the authenticated team. Returns each customer's ID, resource name, descriptive name, currency, time zone, manager / test flags, and status.
When include_details is true (default), the tool issues a per-customer GAQL query to enrich the response with descriptive name, currency, time zone, manager, test, and status. Set it to false for a faster ID-only response.
Parameters
| Parameter | Type | Description |
|---|---|---|
include_details |
boolean |
When true (default), enrich each accessible customer with descriptive_name, currency_code, time_zone, manager, test_account, and status. When false, only IDs and resource names are returned. |
login_customer_id |
string | undefined |
Optional manager (MCC) customer ID for the login-customer-id header. Required when discovering accounts via an MCC. Accepts dashed (123-456-7890) or digits-only (1234567890) format. |
Example
Natural Language
What Google Ads accounts do I have access to?
List my Google Ads customers
Direct Query
{
"tool": "list_ad_accounts",
"arguments": {
"include_details": true
}
}
Response
Returns a list of customer accounts. Each entry includes the 10-digit customer ID, resource name, and (when include_details=true) descriptive name, currency, time zone, manager flag, test-account flag, and status.
Related
- list_campaigns Next: list campaigns inside a customer
- get_insights Pull performance metrics for a customer