list_meta_pages

Meta Ads Read

User wants to know which Facebook Page an ad will run from, or a create/add tool reported the account has 2+ Pages and you need to pick one

Endpoint

POST https://api.adspirer.ai/api/v1/tools/list_meta_pages/execute

Headers

Authorization: Bearer sk_live_... — your Adspirer API key (required)
Content-Type: application/json (required)
Idempotency-Key: <uuid> — recommended for write operations to make retries safe

Description

User wants to know which Facebook Page an ad will run from, or a create/add tool reported the account has 2+ Pages and you need to pick one.

Returns every Facebook Page that can run ads on the ad account (id + name + any linked Instagram account).

Workflow:
1. Call this tool to discover the account's promotable Pages.
2. Pass the chosen page's id to any Meta create/add tool via the `facebook_page_id` parameter.

When to use:
- When a create/add tool returns `needs_page_disambiguation` (the account has 2+ Pages and Meta has no default).
- When the user asks "which Facebook Page will this run from?" or wants a specific Page.
- Before creating a campaign on an account you know has multiple Pages, to choose deliberately rather than let it ask.

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`ad_account_id`	`string` optional	Meta ad account ID (e.g., 'act_123456'). If not provided, uses the connected account.

Example request

{
  "arguments": {
    "ad_account_id": "string"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for list_meta_pages)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "list_meta_pages"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "list_meta_pages"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "list_meta_pages",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: Meta Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai