Draft a Reddit ad
draft_reddit_adDraft a Reddit ad: creates a post on the profile, then the ad (PAUSED) — PREVIEW.
click_url and the media URLs are checked before drafting, so ads do not point at unverified pages and Reddit gets real image and video files. Comments are public on Reddit ads. With post_id an EXISTING post is promoted instead, keeping its upvotes and comments: no post is created and the copy arguments are ignored. Returns a preview with a plan_id; nothing changes until confirm_and_apply applies it. Once enabled, the ad goes through Reddit policy review (PENDING_APPROVAL).
Reddit Ads API: https://ads-api.reddit.com/docs/v3/
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Post body text, up to 40,000 characters. Optional for media posts. | |
| ad_name | No | Ad name; empty uses the headline. Truncated to 200 characters. | |
| post_id | No | Existing post to promote (t3_...); headline, body, the media arguments, call_to_action and display_url are then ignored. Empty creates a new post. | |
| headline | No | Post headline, required for a new post, at most 300 characters. | |
| click_url | No | Landing page (http:// or https://). Required for a new post. TEXT posts open themselves, so the full click_url must also appear in body. With post_id, TEXT posts take no click_url and media posts default it to the post's destination. | |
| image_url | No | Publicly reachable image URL, required for IMAGE posts. | |
| post_type | No | TEXT (headline + optional body; default), IMAGE (public image_url), VIDEO (public video_url + thumbnail_url) or CAROUSEL (2 to 6 carousel_cards). | TEXT |
| video_url | No | Direct link to the video file (MP4 or MOV, up to 1 GB), required for VIDEO posts. Reddit downloads it when the post is created; a page that embeds the video does not work. | |
| profile_id | No | Reddit profile that authors the post, from list_reddit_funding_instruments (profiles). Required for a new post; with post_id it defaults to the post's. | |
| ad_group_id | Yes | Reddit ad group id (from get_reddit_ad_groups). | |
| display_url | No | Optional display URL shown with media posts; must be on the click_url's domain. | |
| ad_account_id | No | Reddit ad account id (from list_reddit_accounts). Empty uses reddit.ad_account_id from the config. | |
| thumbnail_url | No | Publicly reachable image Reddit shows before the video plays, required for VIDEO posts. | |
| allow_comments | No | Whether Redditors can comment publicly on the ad (default true); false disables them. | |
| call_to_action | No | One of Reddit's fixed labels for media posts: Apply Now, Book Now, Buy Tickets, Contact Us, Donate Now, Download, Get a Quote, Get Directions, Get Showtimes, Install, Learn More, Listen Now, Order Now, Play Now, Pre-order Now, Read More, Remind Me, See Menu, Shop Now, Sign Up, Subscribe, View More, Visit Store, Watch Now. On a carousel it is the default for every card. | |
| carousel_cards | No | For CAROUSEL posts, 2 to 6 cards, each {"image_url": "...", "caption": "...", "click_url": "...", "call_to_action": "..."}. Only image_url is required; caption is at most 180 characters, click_url and call_to_action default to the ad's. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||