# meta_create_flexible_ad

> Create a PAUSED ad in Meta's flexible ad format: up to 10 images and videos per group with several primary texts, headlines and descriptions, and Meta picks…

[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 PAUSED ad in Meta's flexible ad format: up to 10 images and videos per group with several primary texts, headlines and descriptions, and Meta picks the format (single image, video or carousel) per placement and person. Sales and App promotion campaigns only. 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. |
| `adSetId` | string | Required | Numeric ID of the existing ad set in the selected account. |
| `name` | string | Required | Exact business name to give this object. Do not derive it from an uploaded filename. |
| `pageId` | string | Required | Numeric ID of the Facebook Page the ad runs as. |
| `instagramUserId` | string | Optional | Instagram account the ad runs as, when it should run on Instagram as that 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. |
| `urlTags` | string | Optional | URL parameters appended to every link, without the leading question mark. |
| `trackingSpecs` | array | Optional | Optional native Meta tracking specifications. Do not supply credentials. |
| `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_create_flexible_ad",
    "args": {
      "adAccountId": "<string>",
      "adSetId": "<string>",
      "name": "<string>",
      "pageId": "<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_create_flexible_ad
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.
