@whop/cli 0.16.0 → 0.16.2

package/skills/whop-ad-campaigns/SKILL.md

@@ -1,204 +0,0 @@
----
-name: whop-ad-campaigns
-description: Platform, objective, and budget for a set of ads. Run `whop ad-campaigns --help` for usage details.
-requires_bin: whop
-command: whop ad-campaigns
----
-
-An Ad Campaign is the top-level container for paid ads on an ad network. It sets the platform, objective, and budget strategy shared by its [ad groups](https://docs.whop.com/api-reference/beta/ad-groups/ad-group) and ads.
-
-Use the Ad Campaigns API to create campaigns, list campaigns for an account, retrieve or update campaign settings, and pause or resume campaign delivery.
-
-# whop ad-campaigns create
-
-Create an Ad Campaign
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | The account to create the campaign under. Defaults to the account-scoped key's own account. |
-| `--bid_type` | `string` | no |  | How delivery bids in the ad auction: `minimum_cost` gets the most results for the budget, `average_target` holds an average cost per result, `maximum_target` never bids above a cap. Only for campaigns that own the budget. |
-| `--budget_amount` | `number` | no |  | The campaign's budget, in the ad account's currency. Required when budget_optimization is `ad_campaign`; omit when each ad group sets its own budget. |
-| `--budget_optimization` | `string` | no |  | Which level owns the budget: the whole campaign (`ad_campaign`) or each ad group individually (`ad_group`). Defaults to `ad_group`. |
-| `--budget_type` | `string` | no |  | Whether the budget is spent per day (`daily`) or over the campaign's full run (`lifetime`). Defaults to `daily`. |
-| `--desired_cost_per_result` | `number` | no |  | Cost per result to aim for (`average_target`) or never exceed (`maximum_target`). Only for campaigns that own the budget. |
-| `--ends_at` | `string` | no |  | When the campaign stops delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--objective` | `string` | yes |  | The goal the campaign optimizes toward. |
-| `--platform` | `string` | yes |  | The ad network the campaign runs on. |
-| `--special_ad_categories` | `array` | no |  | Regulated categories the campaign falls under. Ads in these categories are subject to extra targeting restrictions. |
-| `--starts_at` | `string` | no |  | When the campaign starts delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--title` | `string` | yes |  | The title of the campaign. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns delete
-
-Delete an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns duplicate
-
-Duplicate an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--count` | `number` | no |  | Number of copies to create (1-10). Defaults to 1. |
-| `--preserve_engagement` | `boolean` | no |  | Whether the copied ads keep the original posts' engagement (likes, comments, shares). Defaults to false. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns get
-
-Retrieve an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--stats_from` | `string` | no |  | Start of the stats window. |
-| `--stats_to` | `string` | no |  | End of the stats window. |
-| `--time_zone` | `string` | no |  | IANA timezone the stats window is interpreted in. Defaults to UTC. |
-| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
-
----
-
-# whop ad-campaigns list
-
-List Ad Campaigns
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | The account the campaigns belong to. Defaults to the account-scoped key's own account. |
-| `--status` | `string` | no |  | Only return campaigns with this status. |
-| `--query` | `string` | no |  | Filter campaigns by a title or ID substring. |
-| `--order` | `string` | no |  | The field to sort by. Defaults to created_at. Stat columns (spend, impressions, …) rank over the stats_from/stats_to window across the whole list, not just the current page. results, cost_per_result and return_on_ad_spend rank by the same Whop pixel-attributed values the response reports. |
-| `--direction` | `string` | no |  | The sort direction. Defaults to desc. |
-| `--created_before` | `string` | no |  | Only return campaigns created before this timestamp. |
-| `--created_after` | `string` | no |  | Only return campaigns created after this timestamp. |
-| `--stats_from` | `string` | no |  | Start of the stats window. Defaults to all-time. |
-| `--stats_to` | `string` | no |  | End of the stats window. Defaults to now. |
-| `--time_zone` | `string` | no |  | IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to UTC. |
-| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
-| `--first` | `number` | no | `20` | The number of campaigns to return. |
-| `--after` | `string` | no |  | Cursor to fetch the page after (from page_info.end_cursor). |
-| `--last` | `number` | no |  | The number of campaigns to return from the end of the range. |
-| `--before` | `string` | no |  | Cursor to fetch the page before (from page_info.start_cursor). |
-
----
-
-# whop ad-campaigns pause
-
-Pause an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns retry_payment
-
-Retry a Failed Ad Campaign Payment
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns unpause
-
-Unpause an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns update
-
-Update an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--bid_type` | `string` | no |  | How delivery bids in the ad auction: `minimum_cost` gets the most results for the budget, `average_target` holds an average cost per result, `maximum_target` never bids above a cap. Switching to `minimum_cost` clears the cap amounts stored on the campaign's ad groups. Only for campaigns that own the budget. |
-| `--budget_amount` | `number` | no |  | The campaign budget, in the account's currency. Interpreted as daily or lifetime per the campaign's existing budget type. |
-| `--budget_optimization` | `string` | no |  | Which level owns the budget: the whole campaign (`ad_campaign`) or each ad group individually (`ad_group`). Only changeable before the campaign is live on the ad network; switching to `ad_campaign` requires budget_amount in the same request, and switching to `ad_group` clears the campaign budget. |
-| `--ends_at` | `string` | no |  | When the campaign stops delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--special_ad_categories` | `array` | no |  | Regulated categories the campaign falls under. Editable on any campaign, draft or launched; pass an empty array to clear. |
-| `--starts_at` | `string` | no |  | When the campaign starts delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--status` | `string` | no |  | Set to active to launch a draft campaign (moderates and pushes it live). Live-campaign pause and resume use the pause and unpause actions. |
-| `--title` | `string` | no |  | The name of the campaign. |
-
-> Confirm with the user before executing this destructive command.

package/skills/whop-ad-groups/SKILL.md

@@ -1,269 +0,0 @@
----
-name: whop-ad-groups
-description: Audience, placements, and schedule within a campaign. Run `whop ad-groups --help` for usage details.
-requires_bin: whop
-command: whop ad-groups
----
-
-An Ad Group sits inside an [ad campaign](https://docs.whop.com/api-reference/beta/ad-campaigns/ad-campaign) and controls delivery for [ads](https://docs.whop.com/api-reference/beta/ads/ad). It sets the audience, placements, schedule, budget, and optimization goal for its ads.
-
-Use the Ad Groups API to create ad groups in campaigns, list or retrieve targeting and delivery settings, update budgets or targeting, delete groups that should stop running, and pause or resume delivery. It can also search the ad platform's targeting taxonomy for options to target and estimate how many people a draft targeting spec can reach.
-
-# whop ad-groups create
-
-Create an Ad Group
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--ad_campaign_id` | `string` | yes |  | The ad campaign to create the ad group in, prefixed `adcamp_`. |
-| `--audiences` | `object` | no |  | Saved audiences to deliver to or exclude. Can't be combined with demographics.automatic. |
-| `--bid_type` | `string` | no |  | How delivery bids are set in the ad auction. Target-based strategies use `desired_cost_per_result`. |
-| `--budget_amount` | `number` | no |  | This ad group's budget, in the ad account's currency. Omit when the budget is set on the campaign instead. |
-| `--budget_type` | `string` | no |  | Whether budget_amount is spent per day (`daily`) or over the ad group's full run (`lifetime`). |
-| `--conversion_event` | `unknown` | no |  | The pixel event optimized for. A standard event, or any custom pixel event name. |
-| `--conversion_location` | `string` | no |  | Where the outcome being optimized for occurs, such as a website visit, social-profile visit, messaging conversation, ad interaction, or lead-form submission. The lead form itself is set on the ad. |
-| `--demographics` | `object` | no |  | Age, gender, and automatic-audience targeting. |
-| `--desired_cost_per_result` | `number` | no |  | Cost per result to aim for (`average_target`) or never exceed (`maximum_target`). |
-| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. Entries across interests, behaviors, and demographics are OR'd together (anyone matching any entry is reached), matching Ads Manager's detailed-targeting box. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
-| `--devices` | `object` | no |  | Device platforms and operating systems to target. |
-| `--dynamic_creative` | `boolean` | no |  | Let the ad platform automatically mix and match this ad group's creatives and copy to find the best-performing combinations. Set at creation; can't be changed afterward. |
-| `--ends_at` | `string` | no |  | When the ad group stops delivering, as an ISO 8601 timestamp. Omit to run until paused. |
-| `--frequency_cap` | `object` | no |  | Cap on how often one person sees ads from this ad group. Only available on campaigns with the `awareness` objective. |
-| `--languages` | `array` | no |  | Languages to target, as ISO 639 codes such as `en` or `es`. Empty or omitted targets all languages. |
-| `--message_apps` | `array` | no |  | Apps the conversation opens in. Required when setting `conversion_location` to `messaging`, and rejected unless the ad group's conversion location is `messaging`. |
-| `--minimum_daily_spend` | `number` | no |  | Minimum the ad group tries to spend each day. |
-| `--optimization_goal` | `string` | no |  | The result the ad group's delivery is optimized to get the most of. |
-| `--placements` | `unknown` | no |  | `automatic` to let the ad platform choose placements, or the list of platforms and positions to target. Omit a platform's positions to target all of them.
-
-Valid positions per platform:
-
-- `facebook`: `feed`, `right_hand_column`, `marketplace`, `search`, `profile_feed`, `notification`, `story`, `instream_video`, `facebook_reels`, `facebook_reels_overlay`, `biz_disco_feed`
-- `instagram`: `stream`, `story`, `explore`, `explore_home`, `reels`, `profile_feed`, `profile_reels`, `ig_search`
-- `messenger`: `story`
-- `audience_network`: `classic`, `rewarded_video`
-- `threads`: `threads_stream`
-- `whatsapp`: `status` |
-| `--regions` | `object` | no |  | Locations to target and exclude. |
-| `--starts_at` | `string` | no |  | When the ad group starts delivering, as an ISO 8601 timestamp. Omit to start as soon as it's active. |
-| `--status` | `string` | no |  | Initial status (default: `active`). |
-| `--title` | `string` | no |  | The display name of the ad group. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-groups delete
-
-Delete an Ad Group
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad group ID. |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-groups duplicate
-
-Duplicate an Ad Group
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad group ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--count` | `number` | no |  | Number of copies to create (1-10). Defaults to 1. |
-| `--preserve_engagement` | `boolean` | no |  | Whether the copied ads keep the original posts' engagement (likes, comments, shares). Defaults to false. |
-| `--target_ad_campaign_id` | `string` | no |  | Campaign to duplicate into. Defaults to the ad group's own campaign. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-groups estimate_reach
-
-Estimate Ad Group Reach
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account to estimate on behalf of. Defaults to the authenticated account. |
-| `--audiences` | `object` | no |  | Saved audiences to deliver to or exclude. Can't be combined with demographics.automatic. |
-| `--demographics` | `object` | no |  | Age, gender, and automatic-audience targeting. |
-| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. Entries across interests, behaviors, and demographics are OR'd together (anyone matching any entry is reached), matching Ads Manager's detailed-targeting box. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
-| `--devices` | `object` | no |  | Device platforms and operating systems to target. |
-| `--languages` | `array` | no |  | Languages to target, as ISO 639 codes such as `en` or `es`. Empty or omitted targets all languages. |
-| `--platform` | `string` | yes |  | The ad network the estimate runs on. |
-| `--regions` | `object` | no |  | Locations to target and exclude. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-groups get
-
-Retrieve an Ad Group
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad group ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--stats_from` | `string` | no |  | Start of the stats window. |
-| `--stats_to` | `string` | no |  | End of the stats window. |
-| `--time_zone` | `string` | no |  | IANA timezone the stats window is interpreted in. Defaults to UTC. |
-| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
-
----
-
-# whop ad-groups list
-
-List Ad Groups
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account whose ad groups to list. Defaults to the authenticated account. |
-| `--ad_campaign_id` | `string` | no |  | Filter to ad groups in this campaign. |
-| `--ad_campaign_ids` | `array` | no |  | Filter to ad groups in these campaigns (max 100). Repeat the parameter for each id (ad_campaign_ids=a&ad_campaign_ids=b). |
-| `--status` | `string` | no |  | Filter to ad groups with this status. |
-| `--query` | `string` | no |  | Filter ad groups by a title or ID substring. |
-| `--order` | `string` | no |  | The field to sort by. Defaults to created_at. Stat columns (spend, impressions, …) rank over the stats_from/stats_to window across the whole list, not just the current page. results, cost_per_result and return_on_ad_spend rank by the same Whop pixel-attributed values the response reports. |
-| `--direction` | `string` | no |  | The sort direction. Defaults to desc. |
-| `--created_before` | `string` | no |  | Only return ad groups created before this timestamp. |
-| `--created_after` | `string` | no |  | Only return ad groups created after this timestamp. |
-| `--stats_from` | `string` | no |  | Start of the stats window. Defaults to all-time. |
-| `--stats_to` | `string` | no |  | End of the stats window. Defaults to now. |
-| `--time_zone` | `string` | no |  | IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to UTC. |
-| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
-| `--first` | `number` | no | `20` | The number of ad groups to return. |
-| `--after` | `string` | no |  | Cursor to fetch the page after (from page_info.end_cursor). |
-| `--last` | `number` | no |  | The number of ad groups to return from the end of the range. |
-| `--before` | `string` | no |  | Cursor to fetch the page before (from page_info.start_cursor). |
-
----
-
-# whop ad-groups pause
-
-Pause an Ad Group
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad group ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-groups targeting_options
-
-Search Targeting Options
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account to search on behalf of. Defaults to the authenticated account. |
-| `--platform` | `string` | yes |  | The ad network whose targeting taxonomy to search. |
-| `--query` | `string` | no |  | The search term. Blank browses the fixed lists; interests, work employers, job titles, schools, majors, and locations return nothing without one. |
-| `--types` | `array` | no |  | Kinds of targeting options to search. Defaults to all of them. |
-| `--location_types` | `array` | no |  | Narrow location results to these kinds of places. Only applies when `types` includes `locations`. |
-| `--country` | `string` | no |  | Narrow location results to one country, as an ISO 3166-1 code such as `US`. Only applies when `types` includes `locations`. |
-| `--limit` | `number` | no | `25` | Maximum number of results per requested type. |
-
----
-
-# whop ad-groups unpause
-
-Unpause an Ad Group
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad group ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-groups update
-
-Update an Ad Group
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad group ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--audiences` | `object` | no |  | Saved audiences to deliver to or exclude. Can't be combined with demographics.automatic. |
-| `--bid_type` | `string` | no |  | How delivery bids are set in the ad auction. Target-based strategies use `desired_cost_per_result`. |
-| `--budget_amount` | `number` | no |  | This ad group's budget, in the ad account's currency. Omit when the budget is set on the campaign instead. |
-| `--budget_type` | `string` | no |  | Whether budget_amount is spent per day (`daily`) or over the ad group's full run (`lifetime`). |
-| `--conversion_event` | `unknown` | no |  | The pixel event optimized for. A standard event, or any custom pixel event name. |
-| `--conversion_location` | `string` | no |  | Where the outcome being optimized for occurs, such as a website visit, social-profile visit, messaging conversation, ad interaction, or lead-form submission. The lead form itself is set on the ad. |
-| `--demographics` | `object` | no |  | Age, gender, and automatic-audience targeting. |
-| `--desired_cost_per_result` | `number` | no |  | Cost per result to aim for (`average_target`) or never exceed (`maximum_target`). |
-| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. Entries across interests, behaviors, and demographics are OR'd together (anyone matching any entry is reached), matching Ads Manager's detailed-targeting box. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
-| `--devices` | `object` | no |  | Device platforms and operating systems to target. |
-| `--ends_at` | `string` | no |  | When the ad group stops delivering, as an ISO 8601 timestamp. Omit to run until paused. |
-| `--frequency_cap` | `object` | no |  | Cap on how often one person sees ads from this ad group. Only available on campaigns with the `awareness` objective. |
-| `--languages` | `array` | no |  | Languages to target, as ISO 639 codes such as `en` or `es`. Empty or omitted targets all languages. |
-| `--message_apps` | `array` | no |  | Apps the conversation opens in. Required when setting `conversion_location` to `messaging`, and rejected unless the ad group's conversion location is `messaging`. |
-| `--minimum_daily_spend` | `number` | no |  | Minimum the ad group tries to spend each day. |
-| `--optimization_goal` | `string` | no |  | The result the ad group's delivery is optimized to get the most of. |
-| `--placements` | `unknown` | no |  | `automatic` to let the ad platform choose placements, or the list of platforms and positions to target. Omit a platform's positions to target all of them.
-
-Valid positions per platform:
-
-- `facebook`: `feed`, `right_hand_column`, `marketplace`, `search`, `profile_feed`, `notification`, `story`, `instream_video`, `facebook_reels`, `facebook_reels_overlay`, `biz_disco_feed`
-- `instagram`: `stream`, `story`, `explore`, `explore_home`, `reels`, `profile_feed`, `profile_reels`, `ig_search`
-- `messenger`: `story`
-- `audience_network`: `classic`, `rewarded_video`
-- `threads`: `threads_stream`
-- `whatsapp`: `status` |
-| `--regions` | `object` | no |  | Locations to target and exclude. |
-| `--starts_at` | `string` | no |  | When the ad group starts delivering, as an ISO 8601 timestamp. Omit to start as soon as it's active. |
-| `--status` | `string` | no |  | Initial status (default: `active`). |
-| `--title` | `string` | no |  | The display name of the ad group. |
-
-> Confirm with the user before executing this destructive command.