> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Custom Audiences

> List custom audiences and lookalike audiences from a Meta Ads account

List custom audiences and lookalike audiences from a Meta Ads account. Use name\_search to have Meta find audiences by name instead of paging through the account, and include\_definition only when the audience rule or lookalike specification is needed.

|                      |                              |
| -------------------- | ---------------------------- |
| **App**              | Meta Ads                     |
| **Operation ID**     | `meta_list_custom_audiences` |
| **Type**             | Action                       |
| **Connection**       | `meta_ads` (required)        |
| **Credits per run**  | 1                            |
| **Agent / MCP tool** | Yes                          |

## Inputs

| Field                | Type                       | Required | Default | Description                                                                                                                                                                                                                                                                                                                                |
| -------------------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `account`            | DynamicAccount             | Yes      | -       | Select Meta Ads account, ask the user for it if not provided                                                                                                                                                                                                                                                                               |
| `audience_type`      | string or SelectableOption | Yes      | -       | Type of audiences to list. 'all' returns both custom and lookalike audiences. 'custom' returns custom audiences (website, app, engagement, customer list, etc.). 'lookalike' returns lookalike audiences.                                                                                                                                  |
| `name_search`        | string                     | No       | -       | Return only audiences whose name contains this text. Meta applies this search itself, so it also finds audiences beyond the first page. Meta supports 'contains' only, not 'starts with', so searching 'PN' returns every audience containing 'PN' anywhere in the name.                                                                   |
| `include_definition` | boolean                    | No       | `False` | Include the audience rule and lookalike specification in the response. These can be large, and requesting them for many audiences at once can make Meta reject the request with 'Please reduce the amount of data you're asking for'. Enable it only when the definitions are needed, ideally together with name\_search or a small limit. |
| `limit`              | integer                    | No       | `100`   | Maximum number of audiences to return (1-1000). Default: 100                                                                                                                                                                                                                                                                               |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `List[Dict]`

Returns list of custom/lookalike audiences with id, name, subtype, approximate count, delivery status, etc.

**Fields**: dynamic (depend on the inputs)