get_entity
Fetch the full raw provider payload for one ad entity by provider, type, and id.
Returns the complete, raw provider payload for a single entity — every
provider-native field, not just the lean metadata
list_entities surfaces. Use list_entities to
discover the provider, type, and id first.
Input
| Field | Type | Required | Description |
|---|---|---|---|
provider |
'meta' | 'gads' | 'tiktok' | 'snapchat' | 'dv360' |
yes | The provider that owns the entity. |
type |
string |
yes | Provider-native entity type, e.g. campaign, adset, ad, creative. |
id |
string |
yes | Bare provider-native entity id (no prefix). |
Output
{ entity: … } — the raw provider payload as stored, exactly as the provider
returned it (budgets, targeting, creative bodies, and every other native
field). The shape varies by provider and entity type.
Example
“Show me everything about that ad.”
After finding the ad via list_entities, Claude calls
get_entity({ provider: 'meta', type: 'ad', id: '123456' }) and reads back the
full Meta ad object.
list vs. get
list_entities returns lean metadata for many entities; get_entity returns
the full native payload for exactly one. Reach for get_entity only when you
need fields beyond name / status / type.
Errors
- Entity not found — no such entity, or it isn’t owned by your organization (the two are indistinguishable by design, so a wrong ID and a foreign ID look the same).
- Payload unavailable — the entity is known but its stored payload is temporarily missing.
401 Unauthorized— the OAuth token has expired. Re-authorize from your AI client’s settings.