Skip to content
Get MCP AdsGet MCP Ads, home
Start free
View as Markdown

meta_update_custom_audience

Update an existing custom audience name, description, retention or complete rule.

Update an existing custom audience name, description, retention or complete rule. Does not change audience membership directly. 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

NameTypeRequiredNotes
adAccountIdstringRequiredSelected owning ad account ID, with or without act_. Every referenced ad object must belong to it.
audienceIdstringRequiredNumeric ID of the existing custom audience in this selected ad account.
namestringOptionalExact business name to give this object. Do not derive it from an uploaded filename.
descriptionstringOptionalDescription of the audience purpose.
retentionDaysintegerOptionalAudience retention in days, from 1 to 180; Meta enforces eligibility for the selected subtype.
ruleobjectOptionalComplete native Meta audience rule. Replaces the existing rule on update.
confirmbooleanOptionalApply only when true. Default is a local preview with no API mutation.
validateOnlybooleanOptionalAsk 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_update_custom_audience",
    "args": {
      "adAccountId": "<string>",
      "audienceId": "<string>"
    }
  }
}
Esc

Type to search