> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Experiment

> Update a native Meta A/B experiment or ad study using Meta's update parameters, such as name, schedule, cells or objectives

Update a native Meta A/B experiment or ad study using Meta's update parameters, such as name, schedule, cells or objectives. Meta validates changes allowed in the current study state. Campaign/ad-set budgets and delivery status are separate.

| | |
| - | - |
| **App** | Meta Ads |
| **Operation ID** | `meta_ads_update_experiment` |
| **Type** | Action |
| **Connection** | `meta_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |
| **Requires approval** | Yes (write operation) |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `experiment_id` | string or SelectItem | Yes | - | Meta ad study ID to update. Supply it here, not inside update\_payload. |
| `update_payload` | object or string | Yes | - | Native Meta AdStudy update parameters as an object or JSON string, forwarded unchanged. Example: \{"name":"Work email A/B test","description":"Compare instant-form variants"}. Supported parameters include name, description, start\_time, end\_time, cells, objectives, confidence\_level, client\_business, cooldown\_start\_time, observation\_end\_time, creative\_test\_config, type and viewers. Native timestamp values are Unix seconds. Meta validates which changes are allowed for the study's current state. This does not update campaign/ad-set budgets or delivery status. |
| `dry_run` | boolean | No | `False` | Return the update payload without sending it to Meta. This previews the request; it does not validate it against Meta's API. |

### SelectItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | The value of the selectable item. |
| `label` | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

**Type**: `Dict`

Returns Meta's ad study update response, or the experiment\_id and payload preview when dry\_run is true.

**Fields**: `id`, `experiment_id`, `payload`, `dry_run`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.