account | DynamicAccount | Yes | - | Select the Meta Ads account, ask the user for it if not provided |
campaign_name | string | Yes | - | Name for the campaign |
objective | string or SelectableOption | Yes | - | Campaign’s objective. Select the marketing goal for this campaign |
buying_type | string or SelectableOption | No | - | Buying type for the campaign. Available options: ‘AUCTION’ (Auction - default), ‘RESERVED’ (Reach and Frequency) |
status | string or SelectableOption | No | - | Initial status of the campaign. Available options: ‘ACTIVE’, ‘PAUSED’ (default) |
special_ad_categories | array of string or SelectableOption | No | ['NONE'] | Special ad categories. Defaults to [‘NONE’] if not provided |
special_ad_category_country | array of string or SelectableOption | No | - | Countries for special ad category. Required if special_ad_categories is not [‘NONE’] |
bid_strategy | string or SelectableOption | No | {'value': 'LOWEST_COST_WITHOUT_CAP', 'label': 'Highest volume'} | Bid strategy for the campaign. Available options: ‘LOWEST_COST_WITHOUT_CAP’ (Highest volume - default), ‘COST_CAP’ (Cost per result goal), ‘LOWEST_COST_WITH_BID_CAP’ (Bid Cap), ‘LOWEST_COST_WITH_MIN_ROAS’ |
budget_type | string or SelectableOption | No | - | Budget type for the campaign. Available options: ‘DAILY’ (Daily Budget), ‘LIFETIME’ (Lifetime Budget), ‘ADSET_BUDGET’ (Budget set at ad set level) |
budget_value | integer | No | - | Budget amount as an actual dollar value in the account currency, NOT in cents (e.g., pass 100 for $100). Do not multiply by 100 — the backend converts to cents automatically. Required if budget_type is not ‘ADSET_BUDGET’. |
spend_cap | integer | No | - | Spend cap for the campaign in dollars. Campaign will not spend more than this amount. Not applicable when using lifetime budget. |
start_time | integer | No | - | Start time for campaign delivery (Unix timestamp). Leave empty to start immediately |
stop_time | integer | No | - | End time for campaign delivery (Unix timestamp). Leave empty for no end time |