# meta_create_custom_audience

> Create a website, engagement, customer-list container or lookalike audience.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Meta Ads](https://www.getmcpads.com/docs/sources/meta-ads)

Create a website, engagement, customer-list container or lookalike audience. Does not upload customer data. Terms and eligibility are enforced by Meta. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

> **Warning** This tool changes the account. It is absent from the tool list on the Free plan, and it previews by default: without `confirm: true` it describes the change and applies nothing.

|  |  |
| --- | --- |
| Source | [Meta Ads](https://www.getmcpads.com/docs/sources/meta-ads) |
| Kind | Write |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/meta-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `adAccountId` | string | Required | Selected owning ad account ID, with or without act_. Every referenced ad object must belong to it. |
| `name` | string | Required | Exact business name to give this object. Do not derive it from an uploaded filename. |
| `subtype` | string | Required | Audience type. CUSTOM creates an empty customer-list container; WEBSITE and ENGAGEMENT require a rule; LOOKALIKE requires an origin and lookalikeSpec. One of: `CUSTOM`, `WEBSITE`, `ENGAGEMENT`, `LOOKALIKE`. |
| `description` | string | Optional | Description of the audience purpose. |
| `rule` | object | Optional | Complete native Meta audience rule. Replaces the existing rule on update. |
| `retentionDays` | integer | Optional | Audience retention in days, from 1 to 180; Meta enforces eligibility for the selected subtype. |
| `pixelId` | string | Optional | Numeric ID of the pixel used by a website audience rule. |
| `originAudienceId` | string | Optional | Numeric ID of the source audience in this same ad account. |
| `lookalikeSpec` | object | Optional | Native lookalike specification, including explicit geography and size. Subject to Meta eligibility. |
| `customerFileSource` | string | Optional | Actual provenance of future customer-list data. Creating the container does not upload customer data. One of: `USER_PROVIDED_ONLY`, `PARTNER_PROVIDED_ONLY`, `BOTH_USER_AND_PARTNER_PROVIDED`. |
| `confirm` | boolean | Optional | Apply only when true. Default is a local preview with no API mutation. |
| `validateOnly` | boolean | Optional | Ask Meta to validate, without creating or changing an object. Mutually exclusive with confirm. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "meta_create_custom_audience",
    "args": {
      "adAccountId": "<string>",
      "name": "<string>",
      "subtype": "CUSTOM"
    }
  }
}
```

- [Meta Ads metrics](https://www.getmcpads.com/docs/sources/meta-ads/metrics): What you can ask for.
- [Meta Ads dimensions](https://www.getmcpads.com/docs/sources/meta-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_custom_audience
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.