# meta_update_flexible_ad

> Replace the creative groups of an existing ad in the flexible ad format (images, videos, texts and call to action).

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

Replace the creative groups of an existing ad in the flexible ad format (images, videos, texts and call to action). The ad status is unchanged. 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_write_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. |
| `adId` | string | Required | Numeric ID of the existing ad to modify in the selected account. |
| `groups` | array | Required | Creative groups of the flexible ad format. Each group has at least one image or video, up to 5 texts of each kind, and its call to action. Meta chooses per placement and person how to show the assets. |
| `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_write_tool, since it is not announced

```json
{
  "name": "run_write_tool",
  "arguments": {
    "name": "meta_update_flexible_ad",
    "args": {
      "adAccountId": "<string>",
      "adId": "<string>",
      "groups": "<array>"
    }
  }
}
```

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