# meta_create_ad_study

> Create a Meta A/B test (split test) comparing 2 to 10 cells of campaigns or ad sets of this ad account, with each cell's share of the audience summing to 100.

[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 Meta A/B test (split test) comparing 2 to 10 cells of campaigns or ad sets of this ad account, with each cell's share of the audience summing to 100. Created on the ad account's Business; the campaigns keep their own status and budgets, so paused campaigns spend nothing. Conversion Lift studies are set up with Meta and are not created here. 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. |
| `name` | string | Required | Exact business name to give this object. Do not derive it from an uploaded filename. |
| `description` | string | Optional | What the test compares. |
| `level` | string | Required | What each cell holds: campaigns or ad sets of this ad account. One of: `campaigns`, `adsets`. |
| `startTime` | string | Required | Start of the test, ISO 8601 with UTC offset, in the future. |
| `endTime` | string | Required | End of the test, ISO 8601 with UTC offset, after the start. |
| `cells` | array | Required | The cells; their shares sum to 100 and no entity is in two cells. |
| `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_ad_study",
    "args": {
      "adAccountId": "<string>",
      "name": "<string>",
      "level": "campaigns",
      "startTime": "<string>",
      "endTime": "<string>",
      "cells": "<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_ad_study
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.