Reddit Ads tools
Reddit ad accounts, campaigns, ad groups and performance reports; status and budget changes go through preview and approval and can be undone.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools11 tools
list_reddit_ad_accounts
पढ़ना1 creditsReddit Ads accounts reachable through the connected Reddit login: account_id, name, currency, approval status and which one is selected. Read only; connected=false when Reddit isn't connected.
This tool takes no parameters.
list_reddit_campaigns
पढ़ना1 creditsReddit Ads campaigns of the account: id, name, status, objective, where the budget lives (campaign or ad group), daily or lifetime budget, plus spend, impressions, clicks and conversions of the last N days (UTC, account currency). Read only; never invents numbers.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
daysOptional | integer (1–730) | last N days; default 30 |
statusOptional | active | paused | archived | — |
list_reddit_ad_groups
पढ़ना1 creditsReddit Ads ad groups of the account: id, name, campaign, status, daily or lifetime budget and bid. Use it to find the ad group whose budget to change. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
campaign_idOptional | string | only this campaign's ad groups |
reddit_performance_report
पढ़ना1 creditsReddit Ads delivery report by account, campaign or ad group: spend (account currency), impressions, clicks, key conversions, CTR and CPC with totals, optionally per day. Dates are UTC; data goes back 24 months. Read only; never invents numbers.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
daysOptional | integer (1–730) | last N days; default 30 |
levelOptional | account | campaign | ad_group | — |
campaign_idOptional | string | — |
ad_group_idOptional | string | — |
start_dateOptional | string | YYYY-MM-DD (UTC); overrides days |
end_dateOptional | string | YYYY-MM-DD (UTC) |
by_dateOptional | boolean | one row per day |
list_reddit_ads
पढ़ना1 creditsReddit Ads ads of the account: status, delivery status, rejection reason, post and preview links. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
campaign_idOptional | string | — |
ad_group_idOptional | string | — |
reddit_details
पढ़ना1 creditsFull details of one Reddit Ads object: campaign, ad group, ad, post, post creation job, audience, lead form, profile, catalog, feed, product set, asset or pixel last-fired time. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
kindRequired | campaign | ad_group | ad | post | structured_post | post_job | custom_audience | saved_audience | lead_gen_form | profile | product_catalog | product_feed | product_set | creative_asset | business | pixel_last_fired | upload | — |
idRequired | string | — |
list_reddit_assets
पढ़ना1 creditsList Reddit Ads account assets by kind: funding_instruments, pixels, profiles, apps, custom_audiences, saved_audiences, lead_gen_forms, product_catalogs, posts, structured_posts, creative_assets, catalog_products, product_feeds, product_sets, catalog_imports, funding_allocations. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
kindRequired | string | — |
profile_idOptional | string | — |
catalog_idOptional | string | — |
business_idOptional | string | — |
funding_instrument_idOptional | string | — |
reddit_targeting_search
पढ़ना1 creditsFind Reddit Ads targeting values: communities, community_suggestions, geolocations, interests, languages, devices, carriers, third_party_audiences, third_party_trackers, time_zones, industries, keyword_suggestions. Use the ids in ad group targeting. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
kindRequired | string | — |
queryOptional | string | — |
namesOptional | string | — |
website_urlOptional | string | — |
countryOptional | string | — |
postal_codeOptional | string | — |
seed_keywordsOptional | array<string> | — |
reddit_forecast
पढ़ना1 creditsReddit Ads audience and delivery estimate (delivery: objective, goal_value in micros, ad_group_configs) or bid suggestion (bid: bid_type, targeting, duration, currency). Sends nothing live. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
kindRequired | delivery | bid | — |
configRequired | object | object as documented by the Reddit Ads API v3 |
reddit_account_history
पढ़ना1 creditsChange history of the Reddit Ads account for the period: who changed what. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
daysOptional | integer (1–730) | last N days; default 30 |
start_dateOptional | string | — |
end_dateOptional | string | — |
diagnose_reddit_delivery
पढ़ना1 creditsWhy a Reddit Ads campaign isn't delivering: account approval, payment method, campaign, ad group and ad statuses, rejection reasons and missing pieces, ordered by urgency. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
campaign_idOptional | string | — |
Write tools18 tools
update_reddit_campaign_status
लिखना2 creditsPause or activate a Reddit Ads campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
campaign_idRequired | string | — |
statusRequired | pause | activate | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_reddit_campaign_budget
लिखना2 creditsSet the daily budget of a Reddit Ads campaign that uses campaign budget optimization (budget_level=campaign). Other campaigns keep their budget on ad groups: use update_reddit_ad_group_budget. Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
campaign_idRequired | string | — |
daily_budgetRequired | number | new daily budget in the account currency |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_reddit_ad_group_budget
लिखना2 creditsSet the daily budget of a Reddit Ads ad group (campaigns without campaign budget optimization). Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
ad_group_idRequired | string | — |
daily_budgetRequired | number | new daily budget in the account currency |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_reddit_campaign
लिखना2 creditsCreate a Reddit Ads campaign, always paused. A budget here enables campaign budget optimization; otherwise budget the ad groups. Next: create_reddit_ad_group, create_reddit_post, create_reddit_ad, reddit_status(activate). Undo archives it.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
nameRequired | string | — |
objectiveRequired | app_installs | brand_awareness | catalog_sales | clicks | conversions | impressions | lead_generation | sales | video_viewable_impressions | — |
daily_budgetOptional | number | campaign budget (enables campaign budget optimization), account currency |
lifetime_budgetOptional | number | campaign lifetime budget, account currency |
funding_instrument_idOptional | string | — |
special_ad_categoriesOptional | array<string> | — |
start_timeOptional | string | ISO 8601 UTC |
end_timeOptional | string | ISO 8601 UTC |
scheduleOptional | array<object> | — |
bid_strategyOptional | string | — |
bid_typeOptional | string | — |
bid_valueOptional | number | account currency |
optimization_goalOptional | string | — |
spend_capOptional | number | account currency |
app_idOptional | string | — |
view_through_conversion_typeOptional | string | — |
invoice_labelOptional | string | — |
conversion_pixel_idOptional | string | — |
use_catalogOptional | boolean | — |
campaign_typeOptional | string | AUTOMATED for a Reddit Max campaign |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_reddit_campaign
लिखना2 creditsUpdate a Reddit Ads campaign: name, schedule, bids, payment method, spend cap or lifetime budget (50% per-step limit). Daily budgets use update_reddit_campaign_budget. Undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
campaign_idRequired | string | — |
nameOptional | string | — |
funding_instrument_idOptional | string | — |
bid_strategyOptional | string | — |
bid_typeOptional | string | — |
bid_valueOptional | number | — |
spend_capOptional | number | — |
start_timeOptional | string | ISO 8601 UTC |
end_timeOptional | string | ISO 8601 UTC |
scheduleOptional | array<object> | — |
invoice_labelOptional | string | — |
objectiveOptional | string | — |
use_catalogOptional | boolean | — |
lifetime_budgetOptional | number | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_reddit_ad_group
लिखना2 creditsCreate a paused Reddit Ads ad group with targeting, budget, bid, schedule and optimization goal. Find targeting ids with reddit_targeting_search. Undo archives it.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
nameRequired | string | — |
targetingRequired | object | communities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search |
daily_budgetOptional | number | account currency; not for campaign-budget campaigns |
lifetime_budgetOptional | number | account currency |
bid_strategyOptional | string | — |
bid_typeOptional | string | — |
bid_valueOptional | number | account currency |
optimization_goalOptional | string | — |
start_timeOptional | string | ISO 8601 UTC |
end_timeOptional | string | ISO 8601 UTC |
scheduleOptional | array<object> | — |
app_idOptional | string | — |
conversion_pixel_idOptional | string | — |
view_through_conversion_typeOptional | string | — |
product_set_idOptional | string | — |
saved_audience_idOptional | string | — |
shopping_targetingOptional | object | object as documented by the Reddit Ads API v3 |
shopping_typeOptional | string | — |
optimization_strategy_typeOptional | string | — |
campaign_idRequired | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_reddit_ad_group
लिखना2 creditsUpdate a Reddit Ads ad group: name, targeting, bids, schedule, pixel, optimization goal, saved audience or lifetime budget (50% per-step limit). Daily budgets use update_reddit_ad_group_budget. Undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
nameOptional | string | — |
targetingOptional | object | communities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search |
daily_budgetOptional | number | account currency; not for campaign-budget campaigns |
lifetime_budgetOptional | number | account currency |
bid_strategyOptional | string | — |
bid_typeOptional | string | — |
bid_valueOptional | number | account currency |
optimization_goalOptional | string | — |
start_timeOptional | string | ISO 8601 UTC |
end_timeOptional | string | ISO 8601 UTC |
scheduleOptional | array<object> | — |
app_idOptional | string | — |
conversion_pixel_idOptional | string | — |
view_through_conversion_typeOptional | string | — |
product_set_idOptional | string | — |
saved_audience_idOptional | string | — |
shopping_targetingOptional | object | object as documented by the Reddit Ads API v3 |
shopping_typeOptional | string | — |
optimization_strategy_typeOptional | string | — |
ad_group_idRequired | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_reddit_ad
लिखना2 creditsCreate a paused Reddit Ads ad from a post (post_id from create_reddit_post), a catalog or Reddit Max assets. App install ads need click_url and app_store_id. Undo archives it.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
nameRequired | string | — |
post_idOptional | string | t3_ post id from create_reddit_post |
profile_idOptional | string | — |
click_urlOptional | string | — |
click_url_query_parametersOptional | array<object> | — |
event_trackersOptional | array<object> | — |
productsOptional | array<object> | — |
shopping_creativeOptional | object | object as documented by the Reddit Ads API v3 |
asset_identifiersOptional | array<object> | — |
thumbnail_asset_identifiersOptional | array<object> | — |
destinationOptional | object | object as documented by the Reddit Ads API v3 |
supplementary_textOptional | string | — |
enhancementsOptional | object | object as documented by the Reddit Ads API v3 |
app_store_idOptional | string | — |
ad_typeOptional | string | DYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max |
ad_group_idRequired | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_reddit_ad
लिखना2 creditsUpdate a Reddit Ads ad: name, post, click URL, query parameters, trackers or destination. Undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
nameOptional | string | — |
post_idOptional | string | t3_ post id from create_reddit_post |
profile_idOptional | string | — |
click_urlOptional | string | — |
click_url_query_parametersOptional | array<object> | — |
event_trackersOptional | array<object> | — |
productsOptional | array<object> | — |
shopping_creativeOptional | object | object as documented by the Reddit Ads API v3 |
asset_identifiersOptional | array<object> | — |
thumbnail_asset_identifiersOptional | array<object> | — |
destinationOptional | object | object as documented by the Reddit Ads API v3 |
supplementary_textOptional | string | — |
enhancementsOptional | object | object as documented by the Reddit Ads API v3 |
app_store_idOptional | string | — |
ad_typeOptional | string | DYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max |
ad_idRequired | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
reddit_status
लिखनाIrreversible2 creditsPause, activate or archive a Reddit Ads campaign, ad group or ad. Pause and activate are undoable; archive can't be undone, so confirm with the user first.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
levelRequired | campaign | ad_group | ad | — |
idRequired | string | — |
statusRequired | pause | activate | archive | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_reddit_post
लिखना2 creditsCreate a Reddit ad creative post from public image or video URLs, or as text. Runs as a background job: poll reddit_details(kind=post_job), then use post_id in create_reddit_ad. Can't be undone.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
typeOptional | image | video | text | — |
headlineOptional | string | — |
bodyOptional | string | — |
image_urlOptional | string | — |
video_urlOptional | string | — |
thumbnail_urlOptional | string | — |
destination_urlOptional | string | — |
display_urlOptional | string | — |
call_to_actionOptional | Apply Now | Contact Us | Download | Get a Quote | Get Showtimes | Install | Learn More | Order Now | Play Now | Pre-order Now | See Menu | Shop Now | Sign Up | View More | Watch Now | — |
supplementary_textOptional | string | — |
allow_commentsOptional | boolean | — |
profile_idOptional | string | — |
creativeOptional | object | raw creative for CAROUSEL or PROMOTED_POST |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
upload_reddit_creative_assets
लिखना2 creditsUpload creative assets for Reddit Max ads (images, videos, text, calls to action) to a profile. Check them with reddit_details(kind=upload). Can't be undone.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
profile_idOptional | string | — |
itemsRequired | array<object> | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
manage_reddit_custom_audience
लिखनाIrreversible2 creditsCreate Reddit custom audiences (customer list, website retargeting, engagement), add or remove users by email, or delete one (can't be undone, confirm with the user first).
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
actionRequired | create_customer_list | create_pixel | create_engagement | add_users | remove_users | delete | — |
nameOptional | string | — |
audience_idOptional | string | — |
configOptional | object | object as documented by the Reddit Ads API v3 |
emailsOptional | array<string> | plain or SHA-256; hashed before storing or sending |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
manage_reddit_saved_audience
लिखना2 creditsCreate a Reddit saved audience from targeting, or update one with saved_audience_id; use it in ad groups via saved_audience_id.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
saved_audience_idOptional | string | — |
nameOptional | string | — |
targetingOptional | object | object as documented by the Reddit Ads API v3 |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_reddit_lead_gen_form
लिखना2 creditsCreate a Reddit lead generation form with the privacy link and questions. Can't be undone.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
nameRequired | string | — |
privacy_linkRequired | string | — |
promptOptional | string | — |
questionsRequired | array<object> | {type: EMAIL | FIRST_NAME | LAST_NAME | PHONE_NUMBER | POSTAL_CODE | JOB_TITLE | COMPANY | COMPANY_EMAIL, required} |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
send_reddit_conversion_events
लिखना2 creditsSend server-side conversion events to a Reddit pixel (Conversions API). Use test_id to test. Sending can't be undone; event contents aren't stored.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
pixel_idRequired | string | — |
eventsRequired | array<object> | {event_at, action_source, type: {tracking_type}, click_id, user, metadata} |
test_idOptional | string | send as a test |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
manage_reddit_catalog
लिखनाIrreversible2 creditsManage Reddit product catalogs, feeds, product sets and products: create, update, delete, batch upsert or delete products. Deletions can't be undone, so confirm with the user first. Password-protected feeds are added in Reddit Ads.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
actionRequired | create_catalog | update_catalog | delete_catalog | create_feed | update_feed | delete_feed | create_set | update_set | delete_set | upsert_products | delete_products | — |
business_idOptional | string | — |
catalog_idOptional | string | — |
feed_idOptional | string | — |
set_idOptional | string | — |
bodyOptional | any | fields as documented by the Reddit Ads API v3 |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_reddit_account
लिखना2 creditsChange Reddit ad account settings: name, attribution windows, account-level excluded communities and keywords. Undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Reddit ad account id; defaults to the connection's selected account |
nameOptional | string | — |
attribution_typeOptional | string | — |
app_attribution_typeOptional | string | — |
click_attribution_windowOptional | integer | — |
view_attribution_windowOptional | integer | — |
app_click_attribution_windowOptional | integer | — |
app_view_attribution_windowOptional | integer | — |
excluded_communitiesOptional | array<string> | — |
excluded_keywordsOptional | array<string> | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.