account | DynamicAccount | Yes | - | Select the Reddit Ads account. |
ad_group_id | string or SelectItem | Yes | - | ID of the ad group the ad belongs to. |
ad_name | string | Yes | - | The ad name, used on the dashboard and in reports. |
status | string or SelectableOption | No | PAUSED | Initial ad status. Options: ‘ACTIVE’, ‘PAUSED’. Default: ‘PAUSED’. |
post_id | string or SelectItem | No | - | ID of the post used as the ad creative, from reddit_ads_create_post or reddit_ads_list_posts. Required for all ads except catalog sales product ads. |
click_url | string | No | - | The URL users are directed to when they click the ad. Not used for delivery when shopping_creative is set. |
click_url_query_parameters | array of object or string | No | - | Optional query parameters appended to the click URL, as a JSON list of objects with name and value. Example: [{“name”: “utm_source”, “value”: “reddit”}] |
event_trackers | array of object or string | No | - | Optional third-party tracking URLs as a JSON list, sent as-is. Only URLs from Reddit’s approved measurement providers are accepted. Example: [{“type”: “IMPRESSION”, “url”: “https://tracker.example.com/imp”}] |
profile_id | string or SelectItem | No | - | ID of the ad post’s author profile; required for catalog sales campaigns. |
products | array of object or string | No | - | Optional products associated with the ad (up to 6) as a JSON list using the official Reddit product object, sent as-is. For catalog sales ads. |
shopping_creative | object or string | No | - | Optional shopping creative object for catalog/product ads as JSON, sent as-is using the official Reddit field names. |
