Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.adspirer.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

You can connect unlimited ad accounts across all plans — there is no restriction on how many accounts you link. The difference between plans is how many accounts can be active (used by the agent) at once, per platform:
PlanActive Per Platform (Monthly)Active Per Platform (Annual)
Free11
Plus15
Pro15
Max55
The cap is per platform — every plan counts Google Ads, Meta, LinkedIn, and TikTok independently. A Plus annual customer can activate up to 5 Google Ads accounts and 5 Meta accounts at the same time. When you have 2+ active accounts on a platform, Adspirer’s sequential sub-agents fan out tool calls across them in a single conversation — no manual switching required.

How it works

Your Adspirer account can connect to multiple ad accounts on each platform:
  • Multiple Google Ads customer IDs (including across multiple Google logins — see below)
  • Multiple Meta Business Manager ad accounts (full BM-wide import since May 2026)
  • Multiple LinkedIn Campaign Manager accounts
  • Multiple TikTok Ads Manager accounts
When you first connect on a monthly plan (or Free), one account per platform is active by default — all tool calls target that account. To work in another account, switch via the Manage Accounts modal. On annual plans and on Max monthly, you can activate up to 5 accounts per platform at the same time and let sequential sub-agents fan out tool calls automatically.

Multiple Google logins on one Adspirer account

Agencies and consultants who manage Google Ads across separate Google identities can attach multiple Google OAuth grants to a single Adspirer account. Each grant contributes its own non-overlapping set of Google Ads customer IDs; the agent routes tool calls to the right OAuth based on which customer you reference. Add a second login from Connections → Google Ads → Add another Google login. Available on Max annual today; rolling to other paid tiers as the feature_multi_google_oauth rollout completes.

Switching Accounts

To change which account you’re managing:
Switch to my Google Ads account 123-456-7890
Or use the tool directly:
switch_primary_account(platform="google_ads", account_id="1234567890")
The switch persists for your current session. All subsequent tool calls target the new account until you switch again.

Sequential sub-agents (Max plan)

The Max plan unlocks sequential sub-agents — a workflow where Adspirer fans out tool calls across multiple ad accounts in a single conversation, without manual switching. Instead of one primary account per platform, Max users mark multiple accounts as active, and the agent runs sub-agents per account in sequence. This is the model agencies and portfolio managers use to run cross-account audits, weekly briefs, and bulk optimizations from one prompt.

Active accounts vs. primary account

PlanCap (per platform)Account modelHow tool calls resolve
Free1Single active accountTool calls target the active account; switch from Manage Accounts
Plus monthly / Pro monthly1Single active accountTool calls target the active account; switch from Manage Accounts
Plus annual / Pro annual5Multiple active accountsSequential sub-agents iterate over each active account automatically
Max (monthly or annual)5Multiple active accountsSequential sub-agents iterate over each active account automatically

Discovering active accounts

Max users start a session by listing all active accounts:
List my connected ad accounts
Or call the tool directly:
list_connected_accounts()
This returns every active account with its platform, account ID, name, and status. Filter by platform when needed:
list_connected_accounts(platform="google_ads")
list_connected_accounts makes zero API calls — it reads from the database, so it doesn’t count against your tool call quota or platform rate limits.

Example: cross-account weekly brief

A Max user managing multiple client Google Ads accounts can run:
Run last week's performance brief across all my Google Ads accounts.
Adspirer’s sequential sub-agents call get_campaign_performance once per active account, aggregate the results, and return a single consolidated brief — no per-account switching required.

Targeting one account at a time

Even on Max, you can scope a single tool call to one account by passing the platform-specific account ID:
PlatformParameterExample
Google Adscustomer_id"123-456-7890"
Meta Adsad_account_id"act_123456789"
TikTok Adsadvertiser_id"7012345678901234"
LinkedIn Adsaccount_id"512345678"

Managing your active set

You can change which accounts are active from the Adspirer dashboard at adspirer.ai/connections. Add or remove accounts from your active set at any time. If you downgrade from a higher tier and end up over the new cap, Adspirer demotes excess accounts to inactive automatically — primary-set accounts kept first, then most-recently-synced. You won’t lose history; the accounts are still connected and you can re-activate them after upgrading again. Teams that need more than 5 active accounts per platform — or multi-seat access pooled across planners — should look at the Adspirer Enterprise plans for agencies and teams, which scale sequential sub-agents across up to 200 ad accounts.

For Agencies

If you manage ads for multiple clients:
  1. Connect all client accounts through OAuth (each client authorizes separately)
  2. Start each session by confirming which client you’re working with:
    Show me all my connected ad accounts
    
  3. Switch to the client you want to manage:
    Switch to the Google Ads account for [Client Name]
    
  4. Run your workflow — all tool calls target that client’s account
Always verify the active account before creating campaigns. Running get_connections_status at the start of each session prevents accidentally modifying the wrong client’s campaigns.

Cross-Account Reports

Pull performance data from multiple accounts in one request:
Compare performance across all my Google Ads accounts for the last 30 days.
Show spend, conversions, and CPA for each account.

FAQ

No hard limit. Connect as many ad accounts as you manage. Tool call limits apply to your Adspirer plan, not to the number of connected accounts.
Yes, with Claude Team or Enterprise. Each team member authenticates with their own Adspirer account and connects their own set of ad accounts. See the Claude setup guide for details.
No. Account switching is a session operation and does not count against your tool call limit.
Not anymore — annual plans on Plus and Pro also activate up to 5 accounts per platform simultaneously, the same as Max. Free and monthly Plus/Pro keep one active account per platform at a time. The Max plan is still the right choice for high-volume tool usage (3,000 calls/month) and stays at 5 active per platform on either billing interval. Use any 5-active tier when you regularly run cross-account audits, briefs, or bulk optimizations.
A list of all your active ad accounts across platforms — with platform name, account ID, account name, and status. It’s primarily used by Max-tier sequential sub-agents to fan out work, but it’s available on any plan. Costs zero tool calls and makes zero API calls (reads from the database).
Last modified on May 27, 2026