Ad accounts

Everything else about paid media is readable without this endpoint — you can already list an organization’s campaigns, read their spend, and see the provider ids a workstream governs. What none of that gives you is the one field every one of those reads and every paid-media lifecycle call needs first: the provider’s own account id. A Google Ads query, a status change, a budget change — every one of them takes an account id as its first argument, and until this endpoint nothing published one. You could see the campaigns; you could not run a single query against them. GET /v1/ad-accounts closes that gap. It asks each of your connected ad integrations to list the accounts it can reach, the same way the integration’s own agent tools would, and returns them in one shape regardless of provider.

What comes back

{
  "ad_accounts": [
    {
      "provider": "google_ads",
      "account_id": "1234567890",
      "name": "Northline Residences",
      "currency_code": "USD",
      "time_zone": "America/New_York",
      "is_manager": false
    },
    {
      "provider": "google_ads",
      "account_id": "5302012239",
      "name": "Erdo AI",
      "currency_code": "USD",
      "time_zone": "America/New_York",
      "is_manager": true
    }
  ]
}

Field	Meaning
`provider`	The integration the account belongs to — `google_ads` today.
`account_id`	The provider’s own identifier, unformatted (a Google Ads customer id as ten digits, no dashes). This is the value every provider read, and every paid-media lifecycle call, wants as `customer_id`.
`name`	The account’s own descriptive name — for showing a person which account is meant. Never used to identify one; address accounts by `account_id`.
`currency_code`	The currency the account reports spend in. Accounts under the same organization are not required to share one, so read this before comparing spend across them.
`time_zone`	The account’s own reporting timezone — see below.
`is_manager`	Whether the account is a manager (MCC) account. See below.

Manager accounts return empty, not an error

is_manager is the field worth reading before you use an id, not after something goes wrong. A manager (MCC) account administers other accounts and holds no campaigns of its own, so a query aimed at one — spend, keywords, a status change — comes back empty rather than failing. That reads as “this account has no advertising,” which is the most misleading answer available: it looks like a finding about the campaigns rather than a mistake about the address. It’s also the ordinary shape here, not an edge case. Erdo provisions managed developments as sub-accounts under a manager — Northline Residences’s campaigns live under the Erdo AI manager account shown above — so an organization’s first account in this list is very often a manager whose id looks just as valid as the operating account underneath it. To make picking correctly the default, operating accounts sort first; a manager comes only after every operating account, and only if the organization has no operating accounts is a manager listed alone. A caller that just takes the first entry takes one it can actually query. Selecting a manager when you connect is a different matter, and does not change this one: it widens which accounts the connection may operate — see below — but a manager still holds no campaigns of its own, so the ids you actually query are its clients’. (This is a different “manager” from Erdo’s own manager accounts, which is about one Erdo organization operating several client organizations. Same word, two unrelated hierarchies — a Google Ads MCC never implies anything about who administers your Erdo org, and vice versa.)

Choosing an account under a manager

is_manager says what a query against an id will find. Which account your connection is for is a separate question, answered when you connect, and the two meet here. Connecting Google Ads lists the accounts that login reaches — including the ones it can only see through a manager — and asks which account the connection is for. An account reached that way is labelled as such, Northline Residences (via Erdo AI), and picking it records both halves: the account the connection operates, and the manager it is operated through. Every request the connection makes then carries that manager as its context, which is what Google requires before it will answer for a client account at all. The token cannot supply this — a login that reaches several accounts cannot say which manager you meant — so the account you picked is where it comes from, and picking an account listed directly (no manager in the label) records the account as its own context. Picking the manager itself is a deliberate, different choice. A manager holds no campaigns, so a connection that could only address the account it selected would have nothing to do. Such a connection instead operates every client under that manager: list_google_ads_accounts returns the manager’s clients alongside the manager, each carrying via_manager to say which manager it was reached through, with operating accounts first as always. Any of those ids can be passed as customer_id to a read or a lifecycle call — Erdo confirms the account really is under the selected manager, then sends the request in that manager’s context. An id outside that hierarchy is refused, and that refusal is what the choice buys. A connection that selected one client account operates that account; a connection that selected a manager operates the accounts under it; neither reaches the rest of what the login happens to see. The refusal names the id and points at the account list, because the accounts a connection can operate are exactly what that list returns. When you assign a different operating Google Ads account to a connection, Erdo checks whether another organization already operates it. If it does, choose an account of your organization’s own; two advertisers sharing one account can interfere with each other’s bidding. A concurrent assignment returns a retryable error. Existing account selections and credential refreshes remain available, including on older shared connections.

Unavailable providers

{
  "ad_accounts": [],
  "unavailable": [
    { "provider": "google_ads", "reason": "Google Ads not connected: token refresh failed: invalid_grant" }
  ]
}

unavailable names a connected provider whose accounts could not be listed, and why — an expired or revoked token, most often. This is deliberately kept apart from an organization simply having no ad accounts: a provider that has never been connected is not reported here at all, because “you have no Meta Ads accounts because you have no Meta Ads” is not a finding, it’s the absence of one. But a provider you did connect going quiet must not just make ad_accounts shorter — a caller comparing this list against campaigns it can already see would otherwise conclude the account had been disconnected, when the real problem is a token that needs reconnecting.

Two businesses in one account collide silently

An ad account is meant to hold one advertiser, and when it holds two, nothing tells you. Google serves at most one ad per account per auction, so two campaigns in the same account bidding on the same query are not competing with the market — they are taking each other’s impressions, and the account-level totals still look healthy. Separately, a campaign optimises toward every account-level primary conversion action unless it is pinned to its own goal, so a campaign selling one thing can spend against the conversions of everything else in the account. Because neither shows up as an error, Erdo states them where the decision is made rather than leaving them to be found later:

When a campaign is created, conversion_action_ids puts it on its own conversion goal, so it optimises toward its own conversions only. Created without it in an account holding several businesses’ primaries, the result names every conversion action the campaign will otherwise chase — and the approval card says so before anything is created.
When a campaign is enabled, and when a keyword is added, the result names every other enabled campaign in the same account already bidding on the same keywords. These are warnings, not refusals: overlap is sometimes deliberate, and the change is approval-gated already.
inherit_negative_keywords_from_campaign_ids copies the negative keywords sibling campaigns already carry onto a new one, so a campaign does not launch without the junk filter the rest of its family has.

A check Erdo could not make is reported as unknown rather than as clean — an account that could not be read is not an account with nothing to report. The durable answer is one ad account per business, which is what manager accounts provision. These warnings are for the accounts that already hold more than one. The same account sharing shapes how Erdo bids. Campaigns in one organization share a bidding strategy so their conversions add up into something Google can learn from, and that strategy is named after the organization precisely so a shared account cannot pool two businesses into one bidder — see How Erdo bids.

Timezone decides where “yesterday” falls

time_zone is the account’s own reporting timezone, and it matters the moment you compare this account against a daily figure. A provider’s “yesterday” is yesterday in that account’s timezone, not the caller’s and not UTC — the same reason a scheduled action lets you set an explicit timezone rather than defaulting silently. Read it here before joining anything to a day boundary.

Reading it

REST

curl https://api.erdo.ai/v1/ad-accounts \
  -H "Authorization: Bearer YOUR_API_KEY"

In chat or over MCP, erdo_list_ad_accounts returns the same list, so an agent can pick an operating account for itself before running a provider query rather than guessing at an id.

Feeding other calls

This is a lookup step, not a destination — the account_id it returns is what you pass as customer_id everywhere else that asks for one. A scheduled action’s steps run against a specific provider account:

{ "name": "performance", "app": "google_ads", "key": "query_google_ads",
  "input": {
    "customer_id": "1234567890",
    "query": "SELECT campaign.id, metrics.cost_micros FROM campaign WHERE campaign.id IN ({{scope.ids}}) AND segments.date DURING YESTERDAY"
  } }

A paid-media lifecycle call needs the same id to pause a campaign or change its budget:

{ "provider": "google_ads", "customer_id": "1234567890", "status": "paused" }

In both cases, 1234567890 is the account_id this endpoint returned for Northline Residences — not the 5302012239 beside it, which is the manager and holds no campaigns to query, pause, or re-budget.

Paid-media campaign lifecycle

Pause, resume, or re-budget a campaign in the account this endpoint names.

Scheduled actions

Declare reads and judgements that run against an account on a clock.

Manager accounts

Erdo’s own manager/managed-organization hierarchy — a different “manager” from the one this page reports.

Page tracking

The equivalent read for what’s tagging your pages, rather than what you can advertise from.

Get started

Features

Connect Erdo

Ad accounts

Ad accounts

What comes back

Manager accounts return empty, not an error

Choosing an account under a manager

Unavailable providers

Two businesses in one account collide silently

Timezone decides where “yesterday” falls

Reading it

Feeding other calls

Paid-media campaign lifecycle

Scheduled actions

Manager accounts

Page tracking

​Ad accounts

​What comes back

​Manager accounts return empty, not an error

​Choosing an account under a manager

​Unavailable providers

​Two businesses in one account collide silently

​Timezone decides where “yesterday” falls

​Reading it

​Feeding other calls

​Related

Paid-media campaign lifecycle

Scheduled actions

Manager accounts

Page tracking

Ad accounts

What comes back

Manager accounts return empty, not an error

Choosing an account under a manager

Unavailable providers

Two businesses in one account collide silently

Timezone decides where “yesterday” falls

Reading it

Feeding other calls

Related