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
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 — 2200 Brickell’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.
(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.)
Unavailable providers
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.
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
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 — theaccount_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:
8834039525 is the account_id this endpoint returned for 2200 Brickell — not the
5302012239 beside it, which is the manager and holds no campaigns to query, pause, or re-budget.
Related
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.