Reddit Ads

Overview

Reddit Ads is Reddit’s advertising platform, enabling you to create and manage ad campaigns targeted by interests, communities, keywords, and demographics across one of the largest discussion networks in the world. With the Reddit Ads integration in SquadOS, your agents can create campaigns, manage ad groups, configure custom audiences, manage product catalogs, and retrieve detailed performance reports in an automated way.

• Official website: https://ads.reddit.com/
• Composio documentation: docs.composio.dev/toolkits/reddit_ads

Authentication

This tool uses OAuth 2.0 (OAUTH2) to connect.

You will need the following fields:

Consult the Composio documentation for the required connection fields.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Reddit Ads.
3. Click the card to open the details and hit Connect.
4. You’re taken to the secure connection page hosted by Composio, where you authorize access to your Reddit Ads account via OAuth 2.0.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available to agents. (Connection-flow details in Organization Tools.)

Available actions

Note

This integration exposes 83 actions in total. The most relevant ones are listed below; see the full list in the Composio documentation.

Create Ad Group

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

Input parameters

Name	Type	Required	Description
data	object	Yes	Ad group configuration data including campaign_id, name, bidding strategy, budget goals, and targeting settings.
ad_account_id	string	Yes	The ID of the ad account to create the ad group under.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Reddit Ads Campaign

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

Input parameters

Name	Type	Required	Description
data	object	Yes	Campaign data containing name, status, objective, and optional configuration parameters.
ad_account_id	string	Yes	The ID of the ad account to create the campaign under. Must match pattern ^(t2|a2)_.*.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Custom Audience

REDDIT_ADS_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: rate limits apply — 3,000 requests per 900 seconds with burst limit of 500 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
data	object	Yes	Custom audience data containing name and type.
ad_account_id	string	Yes	The ID of the parent ad account (format: a2_xxxxx).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Lead Gen Form

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

Input parameters

Name	Type	Required	Description
data	object	Yes	Lead gen form data containing name, privacy link, prompt, and questions.
ad_account_id	string	Yes	The ID of the ad account to create the lead gen form under (format: a2_xxxxx or t2_xxxxx).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Reddit Post

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

Input parameters

Name	Type	Required	Description
data	object	Yes	Post data containing type, headline, body, and optional configuration parameters.
profile_id	string	Yes	The ID of the profile to create a post for. Must match pattern ^t2_.*.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Product Catalog

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

Input parameters

Name	Type	Required	Description
data	object	Yes	The product catalog data object containing name, language, currency, and optional event sources.
business_id	string	Yes	The ID of the parent business.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Product Feed

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

Input parameters

Name	Type	Required	Description
data	object	Yes	The product feed data object containing URL, mode, and optional authentication credentials.
catalog_id	string	Yes	The ID of the parent product catalog.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Product Set

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

Input parameters

Name	Type	Required	Description
data	object	Yes	The product set data object containing name and filter rule.
catalog_id	string	Yes	The ID of the parent product catalog.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Create Saved Audience

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

Input parameters

Name	Type	Required	Description
data	object	Yes	Saved audience configuration including name, type, and targeting parameters.
ad_account_id	string	Yes	The ID of the ad account to create the saved audience under (format: a2_...).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Delete Custom Audience

REDDIT_ADS_DELETE_CUSTOM_AUDIENCE

Tool to delete a Custom Audience by ID from Reddit Ads. Use when you need to permanently remove a custom audience. Rate limits: 3,000 requests per 900 seconds with burst capacity of 500 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
audience_id	string	Yes	The ID of the custom audience to delete.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Get Ad Account by ID

REDDIT_ADS_GET_AD_ACCOUNT

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.

Input parameters

Name	Type	Required	Description
ad_account_id	string	Yes	The ID of the ad account to get. Must match pattern ^(t2|a2)_.*.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Get Campaign by ID

REDDIT_ADS_GET_CAMPAIGN

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.

Input parameters

Name	Type	Required	Description
campaign_id	string	Yes	The ID of the campaign to retrieve.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Get Ad Group

REDDIT_ADS_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. Rate limit: 400 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
ad_group_id	string	Yes	The ID of the ad group to get.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Get A Report

REDDIT_ADS_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 and provides paginated results.

Input parameters

Name	Type	Required	Description
data	object	Yes	The report data parameters including time range, fields, and optional breakdowns.
page.size	integer	No	The number of items to be returned by page.
page.token	string	No	The token for the page to retrieve. Used for pagination.
ad_account_id	string	Yes	The ID of the ad account to get the ads report under. Example: a2_imh76hh7e126.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Get Authenticated Member

REDDIT_ADS_GET_ME

Tool to get the authenticated member’s information from the Reddit Ads API, including Reddit username, email, name, and phone number. Rate limit: 100 requests per 60 seconds.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Get Post by ID

REDDIT_ADS_GET_POST

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.

Input parameters

Name	Type	Required	Description
post_id	string	Yes	The ID of the promoted post to get. Must match pattern ^t3_.*.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

List Ad Accounts By Business

REDDIT_ADS_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. Rate limit: 400 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
business_id	string	Yes	The ID of the business to get ad accounts for.
ids	string	No	IDs of ad accounts to search for within the business, comma-separated.
page_size	integer	No	The number of items to be returned by page.
page_token	string	No	The token for the page to retrieve.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

List Ad Groups

REDDIT_ADS_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: 400 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
ad_account_id	string	Yes	The ID of the ad account to list ad groups for.
campaign_id	string	No	The ID of the campaign to list ad groups under.
id	array	No	The list of ad group IDs to filter by.
page_size	integer	No	The number of items to be returned per page.
page_token	string	No	The token for the page to retrieve (for pagination).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

List Ads

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

Input parameters

Name	Type	Required	Description
ad_account_id	string	Yes	The ID of the ad account to list ads for.
id	array	No	Optional list of specific ad IDs to filter by.
page.size	integer	No	Number of ads to return per page.
page.token	string	No	Token for retrieving a specific page of results.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

List Campaigns

REDDIT_ADS_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: 400 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
ad_account_id	string	Yes	The ID of the ad account to list campaigns for.
id	array	No	The list of campaign IDs to filter by.
page_size	integer	No	The number of items to be returned per page.
page_token	string	No	The token for the page to retrieve.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

List Lead Gen Forms

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

Input parameters

Name	Type	Required	Description
ad_account_id	string	Yes	The ID of the ad account to list lead gen forms for. Format: a2_<identifier>.
page_size	integer	No	The number of items to return per page.
page_token	string	No	The token for the page to retrieve.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

List Pixels By Ad Account

REDDIT_ADS_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. Rate limit: 30 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
ad_account_id	string	Yes	The ID of the ad account to list pixels for.
page.size	integer	No	The number of items to be returned per page.
page.token	string	No	The token for the page to retrieve.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Query Ad Accounts

REDDIT_ADS_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: 100 requests per 60 seconds.

Input parameters

Name	Type	Required	Description
business_id	string	Yes	The ID of the business to query ad accounts for.
data	object	No	Filter criteria for querying ad accounts.
page_size	integer	No	The number of items to be returned by page.
page_token	string	No	The token for the page to retrieve.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Update Campaign

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

Input parameters

Name	Type	Required	Description
data	object	Yes	Campaign data to update.
campaign_id	string	Yes	The ID of the campaign to update.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.

Update Post

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

Input parameters

Name	Type	Required	Description
data	object	Yes	Post metadata to update.
post_id	string	Yes	The ID of the post to update. Must start with t3_.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error message if execution failed.
successful	boolean	Yes	Whether the action executed successfully.