> ## 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.

# Manage Multiple Ad Accounts with Adspirer

> Manage multiple ad accounts across Google, Meta, Amazon, ChatGPT Ads, LinkedIn, and TikTok Ads from one Adspirer connection. Annual plans activate up to 5 accounts per platform.

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:

| Plan | Active Per Platform (Monthly) | Active Per Platform (Annual) |
| ---- | :---------------------------: | :--------------------------: |
| Free |               1               |               1              |
| Plus |               1               |             **5**            |
| Pro  |               1               |             **5**            |
| Max  |             **5**             |               5              |

The cap is **per platform** — every plan counts Google Ads, Meta, Amazon, ChatGPT Ads, 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](https://adspirer.ai/connections) 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.

You can switch **by business name, right from chat** — Adspirer resolves the name to the right account ID for you:

```
Use my Sahaayak Google Ads account instead
```

This works for **Google MCC child accounts** too: `list_connected_accounts` surfaces connected-but-not-yet-activated child accounts under your manager account, so you can name one and the agent switches to it without a trip to the web app. How the switch resolves depends on your cap:

* **Single-active tiers** (Free, monthly Plus/Pro): the new account **replaces** the active one.
* **Multi-active tiers** (annual Plus/Pro, Max): the new account is **added** to your active set, up to your per-platform cap of 5.

A switch that would exceed your cap is rejected rather than silently dropping another account.

## 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

| Plan                                                  | Cap (per platform) | Account model            | How tool calls resolve                                               |
| ----------------------------------------------------- | :----------------: | ------------------------ | -------------------------------------------------------------------- |
| Free                                                  |          1         | Single active account    | Tool calls target the active account; switch from Manage Accounts    |
| Plus monthly / Pro monthly                            |          1         | Single active account    | Tool calls target the active account; switch from Manage Accounts    |
| Plus annual / Pro annual                              |        **5**       | Multiple active accounts | Sequential sub-agents iterate over each active account automatically |
| <Badge color="yellow">Max</Badge> (monthly or annual) |        **5**       | Multiple active accounts | Sequential 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")
```

<Tip>
  `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.
</Tip>

### 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:

| Platform     | Parameter       | Example              |
| ------------ | --------------- | -------------------- |
| Google Ads   | `customer_id`   | `"123-456-7890"`     |
| Meta Ads     | `ad_account_id` | `"act_123456789"`    |
| Amazon Ads   | `profile_id`    | `"1234567890"`       |
| TikTok Ads   | `advertiser_id` | `"7012345678901234"` |
| LinkedIn Ads | `account_id`    | `"512345678"`        |

### Managing your active set

You can change which accounts are active from the Adspirer dashboard at [adspirer.ai/connections](https://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](/knowledge-base/enterprise), 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

<Tip>
  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.
</Tip>

## 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

<AccordionGroup>
  <Accordion title="Is there a limit to how many accounts I can connect?">
    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.
  </Accordion>

  <Accordion title="Can different team members manage different 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](/ai-clients/claude) for details.
  </Accordion>

  <Accordion title="Does switching accounts cost a tool call?">
    No. Account switching is a session operation and does not count against your tool call limit.
  </Accordion>

  <Accordion title="Do I need the Max plan for multi-account management?">
    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.
  </Accordion>

  <Accordion title="What does `list_connected_accounts` return?">
    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).
  </Accordion>
</AccordionGroup>