Meta Ads / API Reference
meta_ads_create_ab_test
Meta Ads tool. Create an A/B split test (ad study) with mutually exclusive audience cells. Each cell receives a non-overlapping audience slice. Ideal for testing: - Different audiences (same creative) - Different placements - Different objectives Args: name: Study name (required). business_id: Meta Business Manager ID (required). start_time: ISO 8601 start datetime, e.g. '2026-04-01T00:00:00+0000' (required). end_time: ISO 8601 end datetime (required). cells: JSON array of cell configs. Each cell needs 'name', 'treatment_percentage', and optionally 'adsets' list. Example: '[{"name":"Control","treatment_percentage":50,"adsets":[{"id":"123"}]}, {"name":"Test","treatment_percentage":50,"adsets":[{"id":"456"}]}]' confidence_level: Statistical confidence level 0-1. Default 0.95. account_id: Ad account ID for context. Leave blank for .env default.
This is a write tool: it creates ab test in your Meta Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Create ab test in my Meta Ads account for [name], [business id], [start time].
It takes 5 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name |
business_id | string | Yes | Business Id |
start_time | string | Yes | Start Time |
end_time | string | Yes | End Time |
cells | string | Yes | Cells |
confidence_level | number | No | Confidence Level |
account_id | string | No | Account Id |
Related Meta Ads tools
meta_ads_create_admeta_ads_create_ad_creativemeta_ads_create_adsetmeta_ads_create_adset_with_daypartingmeta_ads_create_advantage_plus_campaignmeta_ads_create_advantage_plus_creative
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: