account | DynamicAccount | Yes | - | Select the Reddit Ads account to create the campaign in. |
campaign_name | string | Yes | - | Name of the campaign (3-500 characters). |
objective | string or SelectableOption | Yes | - | The campaign objective. Options: ‘APP_INSTALLS’, ‘CATALOG_SALES’, ‘CLICKS’, ‘CONVERSIONS’, ‘IMPRESSIONS’, ‘LEAD_GENERATION’, ‘VIDEO_VIEWABLE_IMPRESSIONS’. |
status | string or SelectableOption | No | PAUSED | Initial campaign status. Options: ‘ACTIVE’, ‘PAUSED’. Default: ‘PAUSED’. |
special_ad_category | string or SelectableOption | No | - | Special ad category the campaign falls under; cannot be changed after publishing. Options: ‘NONE’, ‘HOUSING_EMPLOYMENT_CREDIT’. |
funding_instrument_id | string | No | - | Optional campaign-level funding instrument ID. |
app_id | string | No | - | Apple App Store or Google Play app ID for APP_INSTALLS campaigns, for example ‘1064216828’ or ‘com.reddit.frontpage’. |
invoice_label | string | No | - | Free-form label for invoice tracking (max 80 characters). Only applies to campaigns not funded by a credit card. |
spend_cap | number | No | - | Campaign lifetime spend cap in the account currency (converted to microcurrency automatically). Available for non-CBO campaigns and for CBO campaigns with goal_type DAILY_SPEND. |
is_campaign_budget_optimization | boolean | No | False | Enable campaign budget optimization (CBO): budget, bidding, and schedule are managed at the campaign level. Cannot be changed after publishing. When false, budgets and bids are set on ad groups instead. |
goal_type | string or SelectableOption | No | - | CBO budget goal type; cannot be changed after publishing. Options: ‘LIFETIME_SPEND’, ‘DAILY_SPEND’. Required when CBO is enabled. |
goal_value | number | No | - | CBO budget amount in the account currency (converted to microcurrency automatically). Lifetime or daily depending on goal_type. |
bid_strategy | string or SelectableOption | No | - | CBO bid strategy. Options: ‘BIDLESS’, ‘MAXIMIZE_VOLUME’, ‘TARGET_CPX’. In the Reddit Ads UI, ‘BIDLESS’ is called Lowest Cost and ‘MAXIMIZE_VOLUME’ is called Cost Cap. Required when CBO is enabled. |
bid_type | string or SelectableOption | No | - | CBO bid type. Options: ‘CPC’, ‘CPM’, ‘CPV6’. Required when CBO is enabled. |
bid_value | number | No | - | Amount to pay per bidding event in the account currency (converted to microcurrency automatically). Optional when bid_strategy is MAXIMIZE_VOLUME; if set here it cannot also be set on ad groups. |
optimization_goal | string or SelectableOption | No | - | Conversion or video event to optimize for; required for CBO conversions and video views campaigns and cannot be changed later. Common values: ‘PURCHASE’, ‘SIGN_UP’, ‘LEAD’, ‘PAGE_VISIT’, ‘VIDEO_VIEW_6S’, ‘MOBILE_CONVERSION_INSTALL’. |
conversion_pixel_id | string | No | - | Reddit Pixel ID used for measurement and optimization, for example ‘t2_123456’. Required for all CBO campaigns; cannot be changed after publishing. |
view_through_conversion_type | string or SelectableOption | No | - | CBO conversion attribution window; cannot be changed after publishing. Options: ‘SEVEN_DAY_CLICKS’, ‘SEVEN_DAY_CLICKS_ONE_DAY_VIEW’. |
start_time | string | No | - | When the campaign starts delivering, as ISO 8601 (for example 2026-08-01T00:00:00Z) or YYYY-MM-DD. Required when CBO is enabled. |
end_time | string | No | - | When the campaign stops delivering (ISO 8601 or YYYY-MM-DD). Required when goal_type is LIFETIME_SPEND. |