list_adsets

What it does

Parameters

• ad_account_id string required

  Ad account id (list_ad_accounts)

  Matches ^[\w-]{1,64}$

• platform string optional

  Ad platform, default meta

  One of meta, tiktok, snapchat

• campaign_id string optional

  Matches ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

• search string optional

  up to 100 characters

Example

Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_adsets",
    "arguments": {
      "ad_account_id": "act_1234567890"
    }
  }
}

The same call over HTTP with an API key, for an MCP client of your own (an assistant that signs in sends its OAuth token instead):

curl -X POST https://app.apogee.ad/mcp \
  -H "Authorization: Bearer $APOGEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_adsets","arguments":{"ad_account_id":"act_1234567890"}}}'

Access and cost

In the REST API

The same thing for your own code, with an API key:

• List ad sets: GET /ad-accounts/{acc}/adsets

Related tools

Campaigns, ad sets and ads: Names and ids, no metrics: to find where to launch and what to copy.

• list_campaigns: The campaigns of an ad account: objective, CBO budget, status. Archived ones on request.
• list_ads: The ads of an ad account, a campaign or an ad set (200 at most).
• get_latest_in_campaign: The newest ad set and ad of a campaign, by creation time: "copy the latest ad set and ad of campaign X". Their ids go in prepare_launch copy_adset_from and copy_ad_from.
• get_templates: What a copy would take: from an ad set its targeting, event, bid and budget; from an ad its page, Instagram, texts, URL and call to action.
• list_launches: Your launches (the app's History), newest first: status, files, dates.