# meta_update_custom_audience

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

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

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.

> **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. |
| `audienceId` | string | Required | Numeric ID of the existing custom audience in this selected ad account. |
| `name` | string | Optional | Exact business name to give this object. Do not derive it from an uploaded filename. |
| `description` | string | Optional | Description of the audience purpose. |
| `retentionDays` | integer | Optional | Audience retention in days, from 1 to 180; Meta enforces eligibility for the selected subtype. |
| `rule` | object | Optional | Complete native Meta audience rule. Replaces the existing rule on update. |
| `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_update_custom_audience",
    "args": {
      "adAccountId": "<string>",
      "audienceId": "<string>"
    }
  }
}
```

- [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_update_custom_audience
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.