meta_ads_audiences_list
List Meta Ads custom audiences to retrieve audience IDs, subtypes, approximate counts, and retention data. Use it to find the audience_id required for targeting ad sets or building lookalike audiences.
Instructions
Lists Custom Audiences in a Meta Ads account. Returns id, name, subtype (WEBSITE / CUSTOM / LOOKALIKE / APP / etc.), approximate_count, retention_days, and data_source per audience. Read-only. Use this to find an audience_id before targeting an ad set (meta_ads_ad_sets_create / update) or before creating a lookalike (audiences.create_lookalike). Approximate counts from Meta may lag actual size by 24–48h.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "meta_ads_audiences_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum records returned per call. Default 50, max 1000 per Meta Graph API. | |
| account_id | No | Meta Ads account ID in the format 'act_XXXXXXXXXX' (e.g. 'act_1234567890'). Optional — falls back to META_ADS_ACCOUNT_ID from the configured credentials. The leading 'act_' prefix is required. |