मुख्य सामग्री पर जाएँ
Tecrübetecrube.com
Assistant tools · Setup and campaigns

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 credits

Reddit 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 credits

Reddit 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
daysOptionalinteger (1–730)last N days; default 30
statusOptionalactive | paused | archived—

list_reddit_ad_groups

पढ़ना1 credits

Reddit 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
campaign_idOptionalstringonly this campaign's ad groups

reddit_performance_report

पढ़ना1 credits

Reddit 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
daysOptionalinteger (1–730)last N days; default 30
levelOptionalaccount | campaign | ad_group—
campaign_idOptionalstring—
ad_group_idOptionalstring—
start_dateOptionalstringYYYY-MM-DD (UTC); overrides days
end_dateOptionalstringYYYY-MM-DD (UTC)
by_dateOptionalbooleanone row per day

list_reddit_ads

पढ़ना1 credits

Reddit Ads ads of the account: status, delivery status, rejection reason, post and preview links. Read only.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
campaign_idOptionalstring—
ad_group_idOptionalstring—

reddit_details

पढ़ना1 credits

Full 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
kindRequiredcampaign | 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—
idRequiredstring—

list_reddit_assets

पढ़ना1 credits

List 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
kindRequiredstring—
profile_idOptionalstring—
catalog_idOptionalstring—
business_idOptionalstring—
funding_instrument_idOptionalstring—

reddit_forecast

पढ़ना1 credits

Reddit 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
kindRequireddelivery | bid—
configRequiredobjectobject as documented by the Reddit Ads API v3

reddit_account_history

पढ़ना1 credits

Change history of the Reddit Ads account for the period: who changed what. Read only.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
daysOptionalinteger (1–730)last N days; default 30
start_dateOptionalstring—
end_dateOptionalstring—

diagnose_reddit_delivery

पढ़ना1 credits

Why 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
campaign_idOptionalstring—

Write tools18 tools

update_reddit_campaign_status

लिखना2 credits

Pause or activate a Reddit Ads campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
statusRequiredpause | activate—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_reddit_campaign_budget

लिखना2 credits

Set 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
daily_budgetRequirednumbernew 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 credits

Set 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
ad_group_idRequiredstring—
daily_budgetRequirednumbernew 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 credits

Create 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
nameRequiredstring—
objectiveRequiredapp_installs | brand_awareness | catalog_sales | clicks | conversions | impressions | lead_generation | sales | video_viewable_impressions—
daily_budgetOptionalnumbercampaign budget (enables campaign budget optimization), account currency
lifetime_budgetOptionalnumbercampaign lifetime budget, account currency
funding_instrument_idOptionalstring—
special_ad_categoriesOptionalarray<string>—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumberaccount currency
optimization_goalOptionalstring—
spend_capOptionalnumberaccount currency
app_idOptionalstring—
view_through_conversion_typeOptionalstring—
invoice_labelOptionalstring—
conversion_pixel_idOptionalstring—
use_catalogOptionalboolean—
campaign_typeOptionalstringAUTOMATED 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 credits

Update 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
nameOptionalstring—
funding_instrument_idOptionalstring—
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumber—
spend_capOptionalnumber—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
invoice_labelOptionalstring—
objectiveOptionalstring—
use_catalogOptionalboolean—
lifetime_budgetOptionalnumber—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_reddit_ad_group

लिखना2 credits

Create a paused Reddit Ads ad group with targeting, budget, bid, schedule and optimization goal. Find targeting ids with reddit_targeting_search. Undo archives it.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
nameRequiredstring—
targetingRequiredobjectcommunities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search
daily_budgetOptionalnumberaccount currency; not for campaign-budget campaigns
lifetime_budgetOptionalnumberaccount currency
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumberaccount currency
optimization_goalOptionalstring—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
app_idOptionalstring—
conversion_pixel_idOptionalstring—
view_through_conversion_typeOptionalstring—
product_set_idOptionalstring—
saved_audience_idOptionalstring—
shopping_targetingOptionalobjectobject as documented by the Reddit Ads API v3
shopping_typeOptionalstring—
optimization_strategy_typeOptionalstring—
campaign_idRequiredstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_reddit_ad_group

लिखना2 credits

Update 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
nameOptionalstring—
targetingOptionalobjectcommunities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search
daily_budgetOptionalnumberaccount currency; not for campaign-budget campaigns
lifetime_budgetOptionalnumberaccount currency
bid_strategyOptionalstring—
bid_typeOptionalstring—
bid_valueOptionalnumberaccount currency
optimization_goalOptionalstring—
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
scheduleOptionalarray<object>—
app_idOptionalstring—
conversion_pixel_idOptionalstring—
view_through_conversion_typeOptionalstring—
product_set_idOptionalstring—
saved_audience_idOptionalstring—
shopping_targetingOptionalobjectobject as documented by the Reddit Ads API v3
shopping_typeOptionalstring—
optimization_strategy_typeOptionalstring—
ad_group_idRequiredstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_reddit_ad

लिखना2 credits

Create 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
nameRequiredstring—
post_idOptionalstringt3_ post id from create_reddit_post
profile_idOptionalstring—
click_urlOptionalstring—
click_url_query_parametersOptionalarray<object>—
event_trackersOptionalarray<object>—
productsOptionalarray<object>—
shopping_creativeOptionalobjectobject as documented by the Reddit Ads API v3
asset_identifiersOptionalarray<object>—
thumbnail_asset_identifiersOptionalarray<object>—
destinationOptionalobjectobject as documented by the Reddit Ads API v3
supplementary_textOptionalstring—
enhancementsOptionalobjectobject as documented by the Reddit Ads API v3
app_store_idOptionalstring—
ad_typeOptionalstringDYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max
ad_group_idRequiredstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_reddit_ad

लिखना2 credits

Update a Reddit Ads ad: name, post, click URL, query parameters, trackers or destination. Undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
nameOptionalstring—
post_idOptionalstringt3_ post id from create_reddit_post
profile_idOptionalstring—
click_urlOptionalstring—
click_url_query_parametersOptionalarray<object>—
event_trackersOptionalarray<object>—
productsOptionalarray<object>—
shopping_creativeOptionalobjectobject as documented by the Reddit Ads API v3
asset_identifiersOptionalarray<object>—
thumbnail_asset_identifiersOptionalarray<object>—
destinationOptionalobjectobject as documented by the Reddit Ads API v3
supplementary_textOptionalstring—
enhancementsOptionalobjectobject as documented by the Reddit Ads API v3
app_store_idOptionalstring—
ad_typeOptionalstringDYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max
ad_idRequiredstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

reddit_status

लिखनाIrreversible2 credits

Pause, 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
levelRequiredcampaign | ad_group | ad—
idRequiredstring—
statusRequiredpause | activate | archive—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_reddit_post

लिखना2 credits

Create 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
typeOptionalimage | video | text—
headlineOptionalstring—
bodyOptionalstring—
image_urlOptionalstring—
video_urlOptionalstring—
thumbnail_urlOptionalstring—
destination_urlOptionalstring—
display_urlOptionalstring—
call_to_actionOptionalApply 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_textOptionalstring—
allow_commentsOptionalboolean—
profile_idOptionalstring—
creativeOptionalobjectraw 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 credits

Upload 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
profile_idOptionalstring—
itemsRequiredarray<object>—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_reddit_custom_audience

लिखनाIrreversible2 credits

Create 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).

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
actionRequiredcreate_customer_list | create_pixel | create_engagement | add_users | remove_users | delete—
nameOptionalstring—
audience_idOptionalstring—
configOptionalobjectobject as documented by the Reddit Ads API v3
emailsOptionalarray<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 credits

Create a Reddit saved audience from targeting, or update one with saved_audience_id; use it in ad groups via saved_audience_id.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
saved_audience_idOptionalstring—
nameOptionalstring—
targetingOptionalobjectobject 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 credits

Create a Reddit lead generation form with the privacy link and questions. Can't be undone.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
nameRequiredstring—
privacy_linkRequiredstring—
promptOptionalstring—
questionsRequiredarray<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 credits

Send 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
pixel_idRequiredstring—
eventsRequiredarray<object>{event_at, action_source, type: {tracking_type}, click_id, user, metadata}
test_idOptionalstringsend 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 credits

Manage 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.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
actionRequiredcreate_catalog | update_catalog | delete_catalog | create_feed | update_feed | delete_feed | create_set | update_set | delete_set | upsert_products | delete_products—
business_idOptionalstring—
catalog_idOptionalstring—
feed_idOptionalstring—
set_idOptionalstring—
bodyOptionalanyfields 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 credits

Change Reddit ad account settings: name, attribution windows, account-level excluded communities and keywords. Undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringReddit ad account id; defaults to the connection's selected account
nameOptionalstring—
attribution_typeOptionalstring—
app_attribution_typeOptionalstring—
click_attribution_windowOptionalinteger—
view_attribution_windowOptionalinteger—
app_click_attribution_windowOptionalinteger—
app_view_attribution_windowOptionalinteger—
excluded_communitiesOptionalarray<string>—
excluded_keywordsOptionalarray<string>—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.