Reddit Ads
Reddit Ads API for managing advertising campaigns, conversions, and account data on Reddit.
Verdict
Common use cases
- Draft ad groups with targeting in chat
- Bulk upload products to dynamic catalogs
- Create lead-gen forms for webinar signups
- Pull campaign performance for client decks
- Sync custom audiences from CRM exports
Integration
- Vendor
- Reddit Ads
- Category
- other
- Auth
- OAUTH2
- Tools
- 50
- Composio slug
reddit_ads
Tools
- Batch Delete Productsdestructive
Tool to delete multiple products from a Reddit Ads product catalog in a single request. Use when you need to remove products from a catalog. Important: This action cannot be undone, and deleted products will be permanently removed from the
- Create Ad Group
Tool to create a new ad group within a Reddit Ads campaign. Use when setting up ad groups with specific bidding strategies, budget goals, and targeting criteria. Note that optimization_goal is required for conversion, video views, catalog s
- Create Batch Products
Tool to create or update multiple products in a catalog in a single batch operation. Use when you need to add up to 1000 products at once. Note: If using a schedule feed, update your feed to ensure your catalog is up to date.
- Create Custom Audience
Tool to create a new Custom Audience in Reddit Ads. Use when you need to create a custom audience for targeted advertising campaigns. Note: This endpoint has rate limits - Custom Audiences Ingestion: 3000 requests per 900 seconds with burst
- Create Lead Gen Form
Tool to create a new lead generation form in Reddit Ads. Use when you need to set up a lead gen form to collect user information such as emails, names, phone numbers, etc. Rate limit: 20 requests per 60 seconds (Leads).
- Create Product Catalog
Tool to create a new product catalog. Use when you need to set up a product catalog for Reddit Ads. After creation, finish setup by manually creating products or linking a product feed.
- Create Product Feed
Tool to create a new feed for a product catalog. Use when setting up product feeds for Reddit catalog sales campaigns. Each catalog can contain up to 2 feeds, but they must be of different types (REPLACE or UPDATE).
- Create Product Set
Tool to create a new product set in a product catalog. Use when you need to define a subset of products from a catalog using filter rules for targeted advertising.
- Create Reddit Ads Campaign
Tool to create a new Reddit Ads campaign for the specified ad account. Use when you need to set up a new advertising campaign with specific objective, budget, and targeting settings. Note: Max campaigns creation isn't currently supported -
- Create Reddit Post
Tool to create a new Reddit post for a specified profile. Use when you need to create promotional content including text, images, videos, or carousel posts. Rate limit: 200 requests per 60 seconds (Creative Management).
- Create Saved Audience
Tool to create a saved audience for a Reddit Ads ad account with targeting criteria. Use when you need to define and save audience segments for ad campaigns. Rate limit: 200 requests per 60 seconds (Campaign Management Write).
- Create Structured Post Creation Job
Tool to create a structured post creation job on Reddit Ads. Use when creating promoted posts with specific creative content (text, image, video, or carousel). Returns a job with status tracking information. Rate limit: 200 requests per 60
- Delete Custom Audiencedestructive
Tool to delete a Custom Audience by ID from Reddit Ads. Use when you need to permanently remove a custom audience. This operation is subject to rate limits: Custom Audiences Ingestion allows 3000 requests per 900 seconds with burst capacity
- Delete Product Catalogdestructive
Tool to delete a product catalog by ID from Reddit Ads. Use when you need to permanently remove a catalog. Important: This action cannot be undone.
- Delete Product Feeddestructive
Tool to delete a feed in a catalog by ID from Reddit Ads. Use when you need to permanently remove a product feed. Important: This action cannot be undone.
- Delete Product Setdestructive
Tool to delete a product set by ID from Reddit Ads. Use when you need to permanently remove a product set. Important: This action cannot be undone.
- Do Keyword Validations
Tool to validate a list of keywords for targeting and check their brand safety status. Use when you need to verify if keywords are safe and valid for ad targeting campaigns. Rate limit: Targeting Taxonomy - 500 requests per 60 seconds.
- Generate Inspiration Creative Summary
Tool to get AI-generated summary of best practices followed by an inspiration creative ad. Use when you need to analyze what makes a Reddit ad successful.
- Get Ad Account by ID
Tool to retrieve details for a specific Reddit ad account by ID. Use when you need to get account information including admin approval status, attribution settings, currency, excluded communities/keywords, and other account configuration. R
- Get ad account history
Get changelog history for a Reddit ad account with filtering options. Use when you need to track changes made to ads, campaigns, or ad groups within an account, including who made changes and when.
- Get Ad Group
Tool to get an ad group by its ID from Reddit Ads API. Use when you need to retrieve details about a specific ad group. Note: Rate limit of 400 requests per 60 seconds applies (Campaign Management Read).
- Get App Last Fired At Report
Tool to retrieve the last time mobile conversion events were fired for a specific app ID. Use when you need to check conversion tracking status or verify that mobile events are being received. Rate limit: 30 requests per 60 seconds (Convers
- Get A Report
Tool to generate a metrics report for ad performance based on specified fields and breakdowns. Use when you need detailed insights and analytics on ad performance, audience engagement, impressions, clicks, spend, and other advertising metri
- Get Authenticated Member
Tool to get the authenticated member's information from the Reddit Ads API. Use when you need to retrieve details about the currently authenticated user including their Reddit username, email, name, and phone number. Rate limit: 100 request
- Get Business by ID
Tool to get business details by ID from the Reddit Ads API. Use when you need to retrieve information about a specific business entity including its name, industry, contact details, and metadata. The member must have memberships to the busi
- Get Campaign by ID
Retrieve a specific Reddit Ads campaign by its ID. Returns comprehensive campaign information including objective, status, budget, targeting, and optimization settings. Rate limited to 400 requests per 60 seconds.
- Get Channel Planning Reach
Tool to retrieve estimated reach data for a given set of targeting parameters. Returns a series of 10 data points representing the reach curve by impressions. Use when planning ad campaigns and estimating potential audience reach based on d
- Get Child Funding Instruments
Tool to retrieve a list of Funding Instrument Allocations for a parent funding instrument. Use when you need to view child allocations, check billing amounts, or verify servability status. Note: This endpoint is rate-limited to 30 requests
- Get Custom Audience
Tool to retrieve a custom audience by ID from Reddit Ads API. Use when you need to fetch detailed information about a specific custom audience including its configuration, status, and size estimates. Rate limit: 500 requests per 60 seconds
- Get Lead Gen Form by ID
Tool to retrieve details for a specific lead generation form by ID from Reddit Ads. Use when you need to get form information including name, prompt, privacy link, questions, and timestamps. Rate limit: 20 requests per 60 seconds (Leads cat
- Get Pixel Last Fired At Report
Tool to retrieve the last time conversion events were fired for a specific conversion pixel. Use when you need to check conversion tracking status or verify that pixel events are being received. Rate limit: 30 requests per 60 seconds (Conve
- Get Post by ID
Tool to retrieve a promoted or organic Reddit post by its ID. Returns post details including type, content, headline, and metadata. Rate limit: 200 requests per 60 seconds (Creative Management).
- Get Product Catalog
Tool to retrieve a specific product catalog by ID from the Reddit Ads API. Use when you need to fetch details about a particular product catalog including its name, language, currency, attached pixels, and product statistics. Rate limit: 70
- Get Product Feed
Tool to retrieve metadata for a specific product feed by ID. Use when you need to fetch details about a particular feed including its URL, schedule, authentication credentials, and update mode.
- Get Product Set
Tool to retrieve metadata for a specific product set by ID from the Reddit Ads API. Use when you need to fetch details about a particular product set including its name, filter rules, and product statistics. Rate limit: 7000 requests/300s (
- Get Profile by ID
Tool to retrieve details for a specific profile by ID from the Reddit Ads API. Use when you need to get profile information including business ID, Reddit username, and modification timestamp. Rate limit: 100 requests per 60 seconds (Busines
- Get Saved Audience
Tool to retrieve a saved audience by ID from Reddit Ads API. Use when you need to fetch detailed information about a specific saved audience including its targeting criteria and status. Rate limit: 400 requests per 60 seconds (Campaign Mana
- Get SKAdNetwork Availability
Tool to get SKAdNetwork IDs availability quota for an iOS app. Use when you need to check how many SKAdNetwork IDs are available for campaigns, ad groups, or ads.
- Get Structured Post by ID
Tool to retrieve a structured post by its ID from the Reddit Ads API. Returns post details including creative content which can be image, text, video, or carousel type. Rate limit: 200 requests per 60 seconds (Creative Management).
- List 3rd Party Audiences
Tool to retrieve all available 3rd party audiences from Reddit Ads API for targeting purposes. Use when you need to get a list of third-party data audiences for ad targeting. Rate limit: Targeting Taxonomy - 500 requests per 60 seconds.
- List Ad Accounts By Business
Tool to get a list of ad accounts under a business on Reddit Ads. Use when you need to retrieve ad accounts associated with a specific business ID. Supports filtering by specific ad account IDs and pagination for large result sets. Rate lim
- List Ad Groups
Tool to list ad groups for a Reddit ad account. Use when you need to retrieve ad groups for campaign management. Rate limit: Campaign Management Read - 400 requests per 60 seconds.
- List Ads
Tool to list ads by ad account on Reddit Ads platform. Use when you need to retrieve advertising campaigns for a specific ad account. Note: Only 1 ad will appear for each Max campaign. Supports filtering by specific ad IDs and pagination fo
- List Campaigns
Tool to list campaigns by ad account with pagination support. Use when you need to retrieve campaigns for a specific Reddit Ads account. Rate limit: Campaign Management Read - 400 requests per 60 seconds.
- List Carriers
Tool to retrieve all available carriers from Reddit Ads API for targeting purposes. Use when you need to get a list of mobile carriers for ad targeting. Rate limit: Targeting Taxonomy - 500 requests per 60 seconds.
- List Catalog Imports
Tool to retrieve all imports for a catalog. Use when you need to list import history and status for a specific product catalog. Rate limit: 7000 requests/300s (burst: 3000 requests/60s).
- List Communities
Tool to list targetable communities matched by their names. Use when you need to find Reddit communities (subreddits) available for ad targeting. Rate limit: Targeting Taxonomy - 500 requests per 60 seconds.
- List Communities Suggestions
Tool to fetch suggested communities for given community names from Reddit Ads API. Use when you need to discover relevant communities for ad targeting based on community names or website URLs. Rate limit: Targeting Taxonomy - 500 requests p
- List Devices
Tool to retrieve all available devices from Reddit Ads API for targeting purposes. Use when you need to get a list of devices (by make and model) for ad targeting. Rate limit: Targeting Taxonomy - 500 requests per 60 seconds.
- Validate Geolocations
Tool to validate a list of geolocations for use in Reddit Ads targeting. Use when you need to check if geolocation IDs or cities are valid for ad targeting before creating or updating campaigns. Rate limit: Targeting Taxonomy - 100 requests
Setup
Setup guide
- 11. In Switchy, open your Space settings and click 'Add Integration'. 2. Search for Reddit Ads and click 'Connect'. 3. You'll be redirected to Reddit's OAuth consent screen — sign in with the Reddit account that manages your ad account. 4. Grant the requested scopes (read/write access to campaigns, catalogs, audiences, and reporting). 5. After authorization, Switchy confirms the connection and shows your linked ad account name. 6. Test it by opening a Space and typing '@Reddit Ads list my active campaigns' — you should see a summary of running campaigns. 7. To invoke tools, @mention Reddit Ads in any message and describe the task (e.g. '@Reddit Ads create an ad group for our spring promo with a $500 daily budget'). 8. For catalog or audience operations, have your catalog ID or audience ID handy — the MCP will prompt you if it needs one.
What teammates see: by default, memories from Reddit Ads are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Launch New Ad Group
@Reddit Ads create an ad group named 'Q2 Product Launch' in campaign ID 12345 with a $300 daily budget, CPM bidding, and targeting users interested in tech and gaming.Open in a Space →
Batch Add Catalog Products
@Reddit Ads add these 10 products to catalog ID 67890: include product IDs, titles, prices, and image URLs from the attached CSV.Open in a Space →
Build Lead-Gen Form
@Reddit Ads create a lead gen form titled 'Webinar Signup' that collects email, first name, and company name, with a thank-you message saying 'We'll send you the Zoom link shortly.'Open in a Space →
Create Custom Audience
@Reddit Ads create a custom audience named 'Past Purchasers' using the email list in the attached file, and set it to match on email addresses.Open in a Space →
Delete Stale Products
@Reddit Ads delete products with IDs 101, 102, 103, 104, and 105 from catalog ID 67890. Confirm before executing.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Reddit Ads, pull all active ad groups for our Q1 campaign and show me their current spend and performance metrics.
Here's a summary of your Q1 campaign's active ad groups: 'Mobile App Install - iOS' has spent $2,340 with 1,850 conversions (CPA $1.26); 'Desktop Awareness - Tech Subs' has spent $1,890 with 340K impressions (CPM $5.56); 'Retargeting - Cart Abandoners' has spent $980 with 125 conversions (CPA $7.84). All three are pacing within budget and meeting their optimization goals. The iOS group is your strongest performer on cost-per-acquisition.
This example shows the MCP's read capabilities across campaign hierarchies. You'll need OAuth scope for ad account read access. Performance data reflects the account's actual state at query time, so numbers will vary. Useful for daily check-ins without opening the Reddit Ads dashboard.
@Reddit Ads, create a new Custom Audience from our email list of newsletter subscribers — I'll paste the hashed emails in the next message.
Custom Audience 'Newsletter Subscribers' created successfully (ID: aud_8x3k9m). The audience is now processing your uploaded email hashes and will be available for targeting in 24-48 hours. Current status: PROCESSING. Note that match rates typically range from 40-60% depending on how many of your subscribers have Reddit accounts. You can check audience size once processing completes.
This demonstrates the MCP's write capabilities for audience management. Be aware of the rate limit: Custom Audiences Ingestion allows 20 requests per minute. The action is immediate but audience matching is asynchronous. You'll need to wait for Reddit's systems to process the list before using it in campaigns.
@Reddit Ads, review our three lead gen forms and draft recommendations for which one to use in our upcoming SaaS trial campaign based on conversion rates.
Analyzed your three forms: 'Enterprise Demo Request' (8.2% conversion, asks for company size + role), 'Free Trial Signup' (12.7% conversion, email + name only), and 'Webinar Registration' (6.1% conversion, includes phone number). For a SaaS trial campaign, I recommend 'Free Trial Signup' — its 12.7% conversion rate is 55% higher than your next-best form, likely because it minimizes friction with just two fields. The Enterprise form's lower rate suggests Reddit users prefer lightweight commitments. Consider A/B testing a variant that adds 'company name' as optional to balance lead quality with volume.
This example pairs the MCP's data retrieval with AI reasoning to provide strategic guidance. The MCP fetches form metadata and performance stats; the AI synthesizes recommendations. Note that lead gen forms have a 20 requests/minute rate limit for creation, though reads are more permissive. Conversion rates shown are illustrative.
Use-case deep-dives
When Reddit Ads wins for product catalog campaigns at scale
A 6-person DTC team running seasonal drops on Shopify needs to push 800+ SKUs into Reddit's catalog system every quarter. The Reddit Ads MCP is the right call here because the batch product tools handle up to 1000 items per request, and the product feed automation keeps inventory in sync without manual CSV uploads. You'll use Create Batch Products for the initial load, then Create Product Feed to link your Shopify export for ongoing updates. The trade-off: if your catalog changes more than twice a day, you'll hit rate limits on the feed refresh. If your team runs fewer than 200 SKUs or updates products hourly, the overhead isn't worth it—stick with Reddit's native UI. For quarterly or monthly catalog pushes at this scale, the MCP saves 4-6 hours per campaign cycle.
When this MCP streamlines multi-variant lead capture testing
A 3-person growth team at a B2B SaaS company is A/B testing lead gen forms across 12 subreddit audiences to find product-market fit signals. The Reddit Ads MCP makes sense because Create Lead Gen Form lets you script form variations (email-only vs. email-plus-phone, different CTAs) and deploy them in minutes instead of clicking through Reddit's UI 12 times. You can version-control your form configs and tie them to specific ad groups programmatically. The boundary: Reddit rate-limits lead gen form creation to 20 requests per minute, so if you're testing more than 20 variants in a single sprint, you'll need to batch your deploys. For teams running fewer than 5 form variants or testing once a quarter, the setup cost outweighs the time saved. At 8-15 variants per month, the MCP cuts deployment time by half.
When Reddit's audience tools justify the MCP for weekly syncs
A 5-person lifecycle marketing team at a mobile app needs to sync churned-user segments from Amplitude into Reddit Custom Audiences every Monday for re-engagement campaigns. The Reddit Ads MCP is the right tool because Create Custom Audience accepts batch uploads and you can automate the Amplitude export-to-Reddit pipeline in a single workflow. The MCP's OAuth2 setup means your data engineer configures auth once and the sync runs unattended. The catch: Reddit's Custom Audience ingestion has strict rate limits, so if you're syncing more than 10 audiences per week or your segments exceed 500k users, you'll need to stagger uploads. For teams syncing fewer than 3 audiences or updating them less than monthly, the manual CSV upload in Reddit's UI is faster. At weekly cadence with 3-8 audiences, the MCP saves 2 hours per week.
Frequently asked
What can I do with Reddit Ads MCP in Switchy?
You can manage Reddit advertising campaigns end-to-end: create ad groups with bidding strategies, build product catalogs for shopping ads, set up lead gen forms, define custom audiences, and batch-manage products. The MCP exposes 50 tools covering campaign setup, audience targeting, catalog operations, and lead collection. It's built for teams running performance marketing on Reddit who want AI assistance with campaign structure and product feed management.
Do I need admin access to connect Reddit Ads?
You need OAuth2 credentials tied to a Reddit Ads account with campaign management permissions. The MCP uses Reddit's standard OAuth2 flow, so whoever connects it must have access to create campaigns, ad groups, and catalogs in your Reddit Ads account. If your account has role-based permissions, ensure the connecting user can write to campaigns and audiences, not just view reports.
Can Reddit Ads MCP pull performance data or just manage campaigns?
The MCP focuses on campaign setup and catalog management—creating ad groups, audiences, product feeds, lead forms. It doesn't expose reporting or analytics tools in the current integration. If you need to pull impression data, CTR, or conversion metrics, use Reddit's reporting API directly or export data from the Reddit Ads dashboard. This MCP is for building campaigns, not analyzing them.
How is this different from using Reddit Ads Manager directly?
Reddit Ads Manager is a UI for clicking through forms; this MCP lets AI agents execute campaign tasks via natural language. You can ask Switchy to "create an ad group targeting tech subreddits with a $500 daily budget" and it calls the API directly. Useful for bulk operations—like batch-deleting 200 products or creating multiple product sets—that are tedious in the UI. The trade-off: no visual preview of ads before they go live.
Who on the team should connect the Reddit Ads integration?
Whoever owns your Reddit Ads account and has OAuth credentials. Typically a performance marketer or growth lead. Once connected, any Switchy workspace member can invoke the tools, but actions run under the connected account's permissions. If your team separates campaign creation from budget approval, connect it under an account with appropriate write access, then use Switchy's workspace roles to control who can trigger ad spend changes.