Reddit Ads

83 tools available

Reddit Ads API for managing advertising campaigns, conversions, and account data on Reddit.

Connect Reddit Ads See 47+ integrations Visit Reddit Ads ↗

Connect Reddit Ads to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Reddit Ads's 83 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Reddit Ads

Trigger on event

Listen for a new event
Parse and validate the payload
Take an action with the linked tool

Daily summary

Pull yesterday's activity
Summarise with the model of your choice
Send the digest via email or Slack

Cross-tool sync

Read records from one app
Transform with a persona
Write the result back via this integration

Reddit Ads actions 83

Every Reddit Ads action below is a callable tool any Definable persona can invoke.

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 sales, and app install campaign objectives.

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 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 - set up Max campaigns in the Ads Manager instead.

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 limit of 500 requests per 60 seconds.

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 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 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 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 seconds (Creative Management).

Delete Custom Audience

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 of 500 requests per 60 seconds.

Delete Product Catalog

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 Feed

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.

Batch Delete Products

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 catalog. If using a scheduled feed, update your feed to keep the catalog synchronized.

Delete Product Set

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.

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 per 60 seconds.

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. Rate limit: 400 requests per 60 seconds (Campaign Management Read).

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 (Conversion Signals).

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 metrics. Supports up to 3 breakdowns (4 with COUNTRY and REGION combination) and provides paginated results.

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 business to access this endpoint.

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 duration, location, age, and gender targeting.

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 per 60 seconds under the Billing rate limit category.

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 (Targeting Taxonomy).

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

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 requests per 60 seconds (Business Manager).

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 (Conversion Signals).

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: 7000 requests/300s (burst: 3000 requests/60s).

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 (burst: 3000 requests/60s).

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 (Business Manager).

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 Management Read).

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 limit: Campaign Management Read (400 requests/60s).

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 for large result sets.

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 per 60 seconds.

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.

List Funding Instruments

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

List Geolocations

Tool to fetch a list of geolocations from Reddit Ads API. Use when you need geographic targeting options. Postal code and City geolocations are excluded by default unless postal_code or cities_search parameters are provided.

List Industries

Tool to retrieve all available industries from Reddit Ads API. Use when you need to get a complete list of industries for targeting or classification purposes. Returns industry IDs and display names.

List Interests

Tool to retrieve all available interests from Reddit Ads API for targeting purposes. Use when you need to get a list of interests for ad targeting. Rate limit: Targeting Taxonomy - 500 requests per 60 seconds.

List Lead Gen Forms

Tool to list lead generation forms for a Reddit Ads ad account. Use when you need to retrieve all lead gen forms associated with a specific ad account. Rate limit: 20 requests per 60 seconds (Leads category).

List My Businesses

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

List Pixels By Ad Account

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

List Pixels by Business

Tool to list all pixels associated with a specific business. Use when you need to retrieve conversion tracking pixels for a business. Rate limited to 30 requests per 60 seconds.

List Posts by Profile

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

List Product Catalogs

Tool to retrieve details for all product catalogs belonging to a business. Use when you need to list all catalogs for a specific business ID. Rate limit: 7000 requests/300s (burst: 3000 requests/60s).

List Product Feeds

Tool to retrieve metadata for all feeds in a product catalog. Use when you need to list all feeds for a specific catalog ID to view feed configurations, URLs, and schedules.

List Product Sets

Tool to retrieve all product sets in a catalog. Use when you need to list product sets for a specific catalog ID. Rate limit: 7000 requests/300s (burst: 3000 requests/60s).

List Products In Product Catalog

Tool to retrieve all products in a Reddit Ads product catalog. Use when you need to list products for advertising campaigns, with optional filtering by approval status, search terms, or specific product IDs.

List Products In Product Set

Tool to retrieve all products in a Reddit Ads product set. Use when you need to list products within a specific product set, with optional filtering by approval status, issue codes, search terms, or specific product IDs.

List Profiles By Ad Account

Tool to list profiles by ad account from Reddit Ads API. Use when you need to retrieve all profiles associated with a specific ad account. Rate limit: 100 requests per 60 seconds (Business Manager tier).

List Profiles By Business

Tool to list profiles by business. Use when you need to retrieve all profiles associated with a specific business. Rate limit: Business Manager allows 100 requests per 60 seconds.

List Saved Audiences

Tool to list saved audiences for a Reddit ad account. Use when you need to retrieve saved audience configurations with their targeting details. Rate limit: 400 requests per 60 seconds (Campaign Management Read).

List Structured Posts

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

List Time Zones

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

List User Custom Audiences

Tool to list all Custom Audiences under an ad account. Use when you need to retrieve custom audiences for targeting in Reddit Ads campaigns. Rate limit: 500 requests per 60 seconds (Targeting Taxonomy).

Query Ad Accounts

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

Query funding instruments by business

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

Search Communities

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

Update Ad Account

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

Update Business

Tool to update a business by ID in Reddit Ads. Use when you need to modify business settings such as name, industry, country, or contact information. Rate limit: 100 requests per 60 seconds for Business Manager operations.

Update Campaign

Tool to update a campaign by ID in Reddit Ads. Use when you need to modify campaign settings such as name, status, budget, or targeting parameters. Rate limit: 200 requests per 60 seconds (Campaign Management Write).

Update Custom Audience Users

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

Update Post

Tool to update a Reddit post by ID. Use when you need to modify post settings like enabling/disabling comments. Rate limit: 200 requests per 60 seconds (Creative Management).

Update Product Catalog

Tool to update a product catalog's name or attached Pixel IDs in Reddit Ads. Use when you need to modify catalog settings such as name or event sources.

Update Product Feed

Tool to update a product feed's metadata in Reddit Ads. Use when you need to modify feed properties such as name, URL, mode, authentication credentials, or schedule configuration.

Update Product Set

Tool to update a product set's name and filter rules in Reddit Ads. Use when you need to modify the name or filter conditions of an existing product set.

Update Saved Audience

Tool to update a saved audience by ID in Reddit Ads. Use when you need to modify saved audience settings such as name, targeting criteria, or status. Rate limit: 200 requests per 60 seconds (Campaign Management Write).

Update Structured Post

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

Frequently asked questions

What can I automate with Reddit Ads on Definable?

Anything Reddit Ads exposes through its API. Common marketing workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 83 Reddit Ads tools directly, then chain the result into another integration without you writing code.

How does Reddit Ads authentication work?

Reddit Ads uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Reddit Ads integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 83 Reddit Ads tools. You only need a separate Reddit Ads subscription if Reddit Ads itself charges per seat or per API call.

Is using Reddit Ads through Definable secure?

Every call from a persona to Reddit Ads is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Reddit Ads on Definable?

Sign up for Definable, open the integrations page, find Reddit Ads, and connect via OAuth or API key. You can immediately attach Reddit Ads to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Reddit Ads actions does Definable expose?

Definable exposes all 83 Reddit Ads actions as callable tools — including `Create Ad Group`, `Create Batch Products`, `Create Reddit Ads Campaign`, plus 80 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Reddit Ads?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations

Connect Reddit Ads to your stack with Workflow