meta_create_custom_audience

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

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.

Source: Meta Ads
Kind: Write
Discovery: Reachable through search_tools and run_tool
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/meta-ads/mcp

ParametersLink to this section

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 itLink to this section

jsonThrough run_tool, since it is not announced

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