account | DynamicAccount | Yes | - | Select the Meta Ads account that owns the ads. |
update_type | enum (single, bulk) | No | single | single (default): use ad_id and placement. bulk: use structured_data, with one row per requested preview. Bulk always returns per-row results, including failures. |
ad_id | string | No | - | Ad ID to preview in single mode. |
placement | string or SelectableOption | No | - | Placement for single mode, e.g. MOBILE_FEED_STANDARD. Bulk rows must each supply their own placement. |
structured_data | array of PreviewRequest or string | No | - | Bulk mode only. Array of rows or JSON array text, each containing ad_id and placement. Example: [{“ad_id”:“123”,“placement”:“MOBILE_FEED_STANDARD”},{“ad_id”:“123”,“placement”:“INSTAGRAM_STANDARD”}]. Up to 1000 rows per run. Row order and duplicates are preserved; top-level ad_id and placement are ignored in bulk mode. |