Business Ad Studies

Updated: Mar 24, 2026

Copy for LLM

Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

Reading

This business owns these ads-related studies. Includes lift studies, split tests and so on.

Example

Select language

GET /v25.0/{business-id}/ad_studies HTTP/1.1
Host: graph.facebook.com

Try it in Graph API Explorer

If you want to learn how to use the Graph API, read our Using Graph API guide

Parameters

This endpoint doesn't have any parameters.

Fields

Reading from this edge will return a JSON formatted result:

{
"data": [],
"paging": {}
}

data

A list of AdStudy nodes.

paging

For more details about pagination, see the Graph API guide.

Error Codes

Error Code	Description
200	Permissions error
100	Invalid parameter
80004	There have been too many calls to this ad-account. Wait a bit and try again. For more info, please refer to /docs/graph-api/overview/rate-limiting#ads-management.
104	Incorrect signature

Creating

/{business_id}/ad_studies

You can make a POST request to ad_studies edge from the following paths:

/{business_id}/ad_studies

When posting to this edge, an AdStudy will be created.

Parameters

Parameter	Description
`cells` list<Object>	Describes the cells in the study. required `description` string `id` int64 `name` string `creation_template` enum {AUTOMATIC_PLACEMENTS, BRAND_AWARENESS, FACEBOOK, FACEBOOK_AUDIENCE_NETWORK, FACEBOOK_INSTAGRAM, FACEBOOK_NEWS_FEED, FACEBOOK_NEWS_FEED_IN_STREAM_VIDEO, IN_STREAM_VIDEO, INSTAGRAM, MOBILE_OPTIMIZED_VIDEO, PAGE_POST_ENGAGEMENT, REACH, TV_COMMERCIAL, TV_FACEBOOK, VIDEO_VIEW_OPTIMIZATION, LOW_FREQUENCY, MEDIUM_FREQUENCY, HIGH_FREQUENCY} `adaccounts` list<int64> `ads` list<numeric string or integer> `adsets` list<numeric string or integer> `campaigns` list<numeric string or integer> `control_percentage` float with at most two digits after decimal point `treatment_percentage` float with at most two digits after decimal point Show child parameters
`client_business` numeric string or integer	Business associated with the study.
`confidence_level` float	Confidence level used in power calculations and final study report.
`cooldown_start_time` integer	Start of the pre-measurement cool-down period. This period ends when the study period starts.
`creative_test_config` JSON object	(Optional) Configuration for launching a 2-5 cell creative test. Specify either daily_budget or lifetime_budget_percentage to set the budget allocation for the study across the cells' ads. The study's "type" field must also be defined as SPLIT_TEST_V2 when creative_test_config is included in the request.
`description` string	The purpose of the study.
`end_time` integer	Time when the study period ends. required
`name` string	Name of the study. required
`objectives` list<Object>	A vector of objects describing the objectives assigned to this study. `id` numeric string or integer `is_primary` boolean `name` string `type` enum {SALES, NONSALES, MAE, TELCO, FTL, MAI, PARTNER, BRANDLIFT, BRAND, MPC_CONVERSION, CONVERSIONS} `offsite_datasets` list<JSON or object-like arrays> `id` numeric string or integer required `event_names` list<string> Show child parameters `adspixels` list<JSON or object-like arrays> `id` numeric string or integer required `event_names` list<string> Show child parameters `customconversions` list<JSON or object-like arrays> `id` numeric string or integer required `event_names` list<string> Show child parameters `applications` list<JSON or object-like arrays> `id` numeric string or integer required `event_names` list<string> Show child parameters `offline_conversion_data_sets` list<JSON or object-like arrays> `id` numeric string or integer required `event_names` list<string> Show child parameters `product_sets` list<JSON or object-like arrays> `id` numeric string or integer required `event_names` list<string> Show child parameters `product_catalogs` list<JSON or object-like arrays> `id` numeric string or integer required `event_names` list<string> Show child parameters Show child parameters
`observation_end_time` integer	The end of the observation period for this study. This period starts when the study period ends.
`start_time` integer	The time when the study period starts. required
`type` enum {LIFT, SPLIT_TEST, CONTINUOUS_LIFT_CONFIG, GEO_LIFT, BACKEND_AB_TESTING, CREATIVE_SPEND_ENFORCEMENT, PORTFOLIO_OPTIMIZER, VERSION_CONTROL}	The type of ad study, such as `SPLIT_TEST` or `LIFT`.
`viewers` list<int>	This study is shared with these people.

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type.

Struct  {
id: numeric string,
}

Error Codes

Error Code	Description
100	Invalid parameter
200	Permissions error

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.