- Category: marketing
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 83
- Triggers: 0
- Slug:
REDDIT_ADS - Version: 20261101_00
Tools
Create Ad Group
Create Ad Group
REDDIT_ADS_CREATE_AD_GROUPTool 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 sales, and app install campaign objectives.Input Parameters
Output
Create Batch Products
Create Batch Products
REDDIT_ADS_CREATE_BATCH_PRODUCTSTool 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.Input Parameters
Output
Create Reddit Ads Campaign
Create Reddit Ads Campaign
REDDIT_ADS_CREATE_CAMPAIGNCreate a Reddit Ads campaign for a specified ad account with an objective, status, budget, and other campaign settings. Max campaigns creation is not currently supported; set up Max campaigns in Ads Manager instead.Input Parameters
Output
Create Custom Audience
Create Custom Audience
Create Lead Gen Form
Create Lead Gen Form
REDDIT_ADS_CREATE_LEAD_GEN_FORMTool 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).Input Parameters
Output
Create Reddit Post
Create Reddit Post
Create Product Catalog
Create Product Catalog
REDDIT_ADS_CREATE_PRODUCT_CATALOGTool 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.Input Parameters
Output
Create Product Feed
Create Product Feed
REDDIT_ADS_CREATE_PRODUCT_FEEDTool 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).Input Parameters
Output
Create Product Set
Create Product Set
Create Saved Audience
Create Saved Audience
Create Structured Post Creation Job
Create Structured Post Creation Job
REDDIT_ADS_CREATE_STRUCTURED_POST_CREATION_JOBTool 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 seconds (Creative Management).Input Parameters
Output
Delete Custom Audience
Delete Custom Audience
REDDIT_ADS_DELETE_CUSTOM_AUDIENCETool 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 of 500 requests per 60 seconds.Input Parameters
Output
Delete Product Catalog
Delete Product Catalog
Delete Product Feed
Delete Product Feed
Batch Delete Products
Batch Delete Products
REDDIT_ADS_DELETE_PRODUCTSTool 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 catalog. If using a scheduled feed, update your feed to keep the catalog synchronized.Input Parameters
Output
Delete Product Set
Delete Product Set
Validate Geolocations
Validate Geolocations
REDDIT_ADS_DO_GEOLOCATION_VALIDATIONSTool 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 per 60 seconds.Input Parameters
Output
Do Keyword Validations
Do Keyword Validations
Generate Inspiration Creative Summary
Generate Inspiration Creative Summary
Get Ad Account by ID
Get Ad Account by ID
REDDIT_ADS_GET_AD_ACCOUNTTool 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. Rate limit: 400 requests per 60 seconds (Campaign Management Read).Input Parameters
Output
Get ad account history
Get ad account history
REDDIT_ADS_GET_AD_ACCOUNT_HISTORYGet 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.Input Parameters
Output
Get Ad Group
Get Ad Group
Get App Last Fired At Report
Get App Last Fired At Report
REDDIT_ADS_GET_APP_LAST_FIRED_ATTool 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 (Conversion Signals).Input Parameters
Output
Get A Report
Get A Report
REDDIT_ADS_GET_A_REPORTTool 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 metrics. Supports up to 3 breakdowns (4 with COUNTRY and REGION combination) and provides paginated results.Input Parameters
Output
Get Business by ID
Get Business by ID
REDDIT_ADS_GET_BUSINESSTool 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 business to access this endpoint.Input Parameters
Output
Get Campaign by ID
Get Campaign by ID
Get Channel Planning Reach
Get Channel Planning Reach
REDDIT_ADS_GET_CHANNEL_PLANNING_REACHRetrieve estimated reach data as a reach-by-impressions curve for campaign planning, based on duration, location, age, and gender targeting. Results support pagination.Input Parameters
Output
Get Child Funding Instruments
Get Child Funding Instruments
REDDIT_ADS_GET_CHILD_FUNDING_INSTRUMENTSTool 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 per 60 seconds under the Billing rate limit category.Input Parameters
Output
Get Custom Audience
Get Custom Audience
REDDIT_ADS_GET_CUSTOM_AUDIENCETool 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 (Targeting Taxonomy).Input Parameters
Output
Get Lead Gen Form by ID
Get Lead Gen Form by ID
REDDIT_ADS_GET_LEAD_GEN_FORMTool 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 category).Input Parameters
Output
Get Authenticated Member
Get Authenticated Member
REDDIT_ADS_GET_METool 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 requests per 60 seconds (Business Manager).Output
Get Pixel Last Fired At Report
Get Pixel Last Fired At Report
REDDIT_ADS_GET_PIXEL_LAST_FIRED_ATTool 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 (Conversion Signals).Input Parameters
Output
Get Post by ID
Get Post by ID
Get Product Catalog
Get Product Catalog
REDDIT_ADS_GET_PRODUCT_CATALOGTool 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: 7000 requests/300s (burst: 3000 requests/60s).Input Parameters
Output
Get Product Feed
Get Product Feed
Get Product Set
Get Product Set
REDDIT_ADS_GET_PRODUCT_SETTool 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 (burst: 3000 requests/60s).Input Parameters
Output
Get Profile by ID
Get Profile by ID
REDDIT_ADS_GET_PROFILETool 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 (Business Manager).Input Parameters
Output
Get Saved Audience
Get Saved Audience
REDDIT_ADS_GET_SAVED_AUDIENCETool 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 Management Read).Input Parameters
Output
Get SKAdNetwork Availability
Get SKAdNetwork Availability
REDDIT_ADS_GET_SK_AD_NETWORK_AVAILABILITYTool 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.Input Parameters
Output
Get Structured Post by ID
Get Structured Post by ID
List 3rd Party Audiences
List 3rd Party Audiences
REDDIT_ADS_LIST3RD_PARTY_AUDIENCESTool 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.Input Parameters
Output
List Ad Accounts By Business
List Ad Accounts By Business
REDDIT_ADS_LIST_AD_ACCOUNTS_BY_BUSINESSTool 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 limit: Campaign Management Read (400 requests/60s).Input Parameters
Output
List Ad Groups
List Ad Groups
List Ads
List Ads
REDDIT_ADS_LIST_ADSList ads for a Reddit ad account, with filtering by ad IDs and pagination. Only one ad will appear for each Max campaign.Input Parameters
Output
List Campaigns
List Campaigns
REDDIT_ADS_LIST_CAMPAIGNSTool 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.Input Parameters
Output
List Carriers
List Carriers
REDDIT_ADS_LIST_CARRIERSTool 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.Input Parameters
Output
List Catalog Imports
List Catalog Imports
List Communities
List Communities
REDDIT_ADS_LIST_COMMUNITIESTool 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.Input Parameters
Output
List Communities Suggestions
List Communities Suggestions
REDDIT_ADS_LIST_COMMUNITIES_SUGGESTIONSTool 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 per 60 seconds.Input Parameters
Output
List Devices
List Devices
REDDIT_ADS_LIST_DEVICESLists available Reddit Ads devices by make and model for ad targeting, returning one page at a time. Rate limit: Targeting Taxonomy - 500 requests per 60 seconds.Input Parameters
Output
List Funding Instruments
List Funding Instruments
REDDIT_ADS_LIST_FUNDING_INSTRUMENTSTool to list funding instruments (payment methods) for a Reddit Ads ad account. Use when you need to retrieve billing information or check available payment methods. Rate limit: 30 requests per 60 seconds (Billing category).Input Parameters
Output
List Geolocations
List Geolocations
List Industries
List Industries
List Interests
List Interests
List Lead Gen Forms
List Lead Gen Forms
REDDIT_ADS_LIST_LEAD_GEN_FORMSLists lead generation forms for a Reddit Ads ad account, returning one page at a time. Rate limit: 20 requests per 60 seconds (Leads category).Input Parameters
Output
List My Businesses
List My Businesses
REDDIT_ADS_LIST_MY_BUSINESSESTool to retrieve details of businesses associated with the provided access token. Use when you need to get a list of businesses the user has access to, with optional filters for ad account ID or user role (BUSINESS_ADMIN or CATALOG_ADMIN).Input Parameters
Output
List Pixels By Ad Account
List Pixels By Ad Account
REDDIT_ADS_LIST_PIXELS_BY_AD_ACCOUNTTool to list pixels by ad account. Use when you need to retrieve conversion pixels for a specific Reddit Ads account. Note: Rate limited to 30 requests per 60 seconds (Conversion Signals).Input Parameters
Output
List Pixels by Business
List Pixels by Business
List Posts by Profile
List Posts by Profile
REDDIT_ADS_LIST_POSTSTool to list up to 1,000 of the most recent posts for a specified profile. Use when you need to retrieve posts from a Reddit profile. Supports filtering by post type (CAROUSEL, IMAGE, TEXT, VIDEO) and source (ORGANIC, PROMOTED). Rate limit: 200 requests per 60 seconds (Creative Management).Input Parameters
Output
List Product Catalogs
List Product Catalogs
List Product Feeds
List Product Feeds
List Product Sets
List Product Sets
List Products In Product Catalog
List Products In Product Catalog
REDDIT_ADS_LIST_PRODUCTS_IN_PRODUCT_CATALOGList a page of products in a Reddit Ads product catalog, with optional filtering by approval status, search terms, or specific product IDs. Returns pagination information.Input Parameters
Output
List Products In Product Set
List Products In Product Set
REDDIT_ADS_LIST_PRODUCTS_IN_PRODUCT_SETList a page of products in a Reddit Ads product set, with optional filtering by approval status, issue codes, search terms, or specific product IDs. Returns pagination information.Input Parameters
Output
List Profiles By Ad Account
List Profiles By Ad Account
REDDIT_ADS_LIST_PROFILES_BY_AD_ACCOUNTList a page of profiles associated with a Reddit Ads ad account, with pagination information. Rate limit: 100 requests per 60 seconds (Business Manager tier).Input Parameters
Output
List Profiles By Business
List Profiles By Business
REDDIT_ADS_LIST_PROFILES_BY_BUSINESSList a page of profiles associated with a business, with pagination information. Rate limit: Business Manager allows 100 requests per 60 seconds.Input Parameters
Output
List Saved Audiences
List Saved Audiences
List Structured Posts
List Structured Posts
REDDIT_ADS_LIST_STRUCTURED_POSTSTool to list structured posts for a profile or retrieve up to 10 specific structured posts by ID. Use when you need to retrieve structured posts owned by a Reddit Ads profile. Rate limit: Creative Management Read - 200 requests per 60 seconds.Input Parameters
Output
List Time Zones
List Time Zones
REDDIT_ADS_LIST_TIME_ZONESTool to retrieve all available time zones from Reddit Ads API for campaign scheduling. Use when you need to get a list of time zones for setting campaign schedules or display times. Rate limit: Campaign Management Read - 400 requests per 60 seconds.Input Parameters
Output
List User Custom Audiences
List User Custom Audiences
Query Ad Accounts
Query Ad Accounts
REDDIT_ADS_QUERY_AD_ACCOUNTSTool to query ad accounts by business with optional filtering by actors, assets, roles, or custom filter string. Use when you need to retrieve ad accounts for a specific business with filtering capabilities. Rate Limit: Business Manager - 100 requests per 60 seconds.Input Parameters
Output
Query funding instruments by business
Query funding instruments by business
REDDIT_ADS_QUERY_FUNDING_INSTRUMENTS_BY_BUSINESSQuery funding instruments (credit lines) by business with pagination support. Use when you need to retrieve or filter funding instruments for a Reddit Ads business account. Requires adsread OAuth scope. Rate limit: 30 requests per 60 seconds (Billing category).Input Parameters
Output
Search Communities
Search Communities
REDDIT_ADS_SEARCH_COMMUNITIESTool to search for Reddit communities based on their name or topic. Use when you need to find subreddits for ad targeting purposes. Returns all communities if no query is provided.Input Parameters
Output
Update Ad Account
Update Ad Account
REDDIT_ADS_UPDATE_AD_ACCOUNTTool to update a Reddit ad account configuration. Use when you need to modify account settings like name, attribution windows, excluded communities/keywords, or account approval state. Subject to Campaign Management Write rate limit: 200 requests per 60 seconds.Input Parameters
Output
Update Business
Update Business
Update Campaign
Update Campaign
Update Custom Audience Users
Update Custom Audience Users
REDDIT_ADS_UPDATE_CUSTOM_AUDIENCE_USERSTool to update users in a Reddit Ads Custom Audience by adding or removing user identifiers. Use when you need to modify audience membership based on hashed user data like emails or mobile advertising IDs. Limited to 2,500 user entries per request.Input Parameters
Output
Update Post
Update Post
Update Product Catalog
Update Product Catalog
Update Product Feed
Update Product Feed
Update Product Set
Update Product Set
Update Saved Audience
Update Saved Audience
Update Structured Post
Update Structured Post
REDDIT_ADS_UPDATE_STRUCTURED_POSTTool to update a structured post by ID. Only allow_comments can be updated on an existing structured post. To change the headline, link, or media assets, create a new structured post instead. Rate limit: 200 requests per 60 seconds (Creative Management).