Documentation version: 2026-11-16.2
Canonical: https://docs.creator.gg/tools/ads_meta_entities_list.md

# ads_meta_entities_list

Read a bounded page of Meta campaigns, ad sets or ads for the connected account. INTEGRATION queries Meta; AD_MANAGER campaigns are only locally published PAUSED/PUBLISHED campaigns. Follow next unchanged; this is not two-way-sync state. Uses Meta IDs, not local campaign record IDs. Read guides/ads-reporting. No paid change or connection change is executed.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: reads data or returns an account-screen link.


## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "adAccountId": "act_123456789",
  "sourceType": "INTEGRATION",
  "entityType": "CAMPAIGN"
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "adAccountId": {
      "type": "string",
      "pattern": "^act_[0-9]{1,40}$"
    },
    "sourceType": {
      "type": "string",
      "enum": [
        "AD_MANAGER",
        "INTEGRATION"
      ]
    },
    "entityType": {
      "type": "string",
      "enum": [
        "CAMPAIGN",
        "ADSET",
        "AD"
      ]
    },
    "campaignId": {
      "description": "Meta parent campaign ID for ADSET/AD.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "adSetId": {
      "description": "Meta ad set ID for AD only, within campaignId.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "next": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "pattern": "^[A-Za-z0-9_.~+=/-]+$",
      "description": "Opaque next cursor returned by the same entity query. Never a URL. Keep account, source and parent unchanged."
    }
  },
  "required": [
    "adAccountId",
    "sourceType",
    "entityType"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [ads-reporting](https://docs.creator.gg/guides/ads-reporting.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)
