Reddit Ads

reddit_ads

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

Marketing Ads & Conversion Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (83)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create Ad GroupREDDIT_ADS_CREATE_AD_GROUPAcción

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.

Parámetros de entrada

dataobjectObligatorio
Ad group configuration data including campaign_id, name, bidding strategy, budget goals, and targeting settings
ad_account_idstringObligatorio
The ID of the ad account to create the ad group under

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Batch ProductsREDDIT_ADS_CREATE_BATCH_PRODUCTSAcción

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.

Parámetros de entrada

dataobject[]Obligatorio
List of products to create or update. Must contain at least 1 and at most 1000 products.
catalog_idstringObligatorio
The ID of the product catalog to add products to.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Reddit Ads CampaignREDDIT_ADS_CREATE_CAMPAIGNAcción

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.

Parámetros de entrada

dataobjectObligatorio
Campaign data containing name, status, objective, and optional configuration parameters.
ad_account_idstringObligatorio
The ID of the ad account to create the campaign under. Must match pattern ^(t2|a2)_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Custom AudienceREDDIT_ADS_CREATE_CUSTOM_AUDIENCEAcción

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.

Parámetros de entrada

dataobjectObligatorio
Custom audience data containing name and type
ad_account_idstringObligatorio
The ID of the parent ad account (format: a2_xxxxx)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Lead Gen FormREDDIT_ADS_CREATE_LEAD_GEN_FORMAcción

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

Parámetros de entrada

dataobjectObligatorio
Lead gen form data containing name, privacy link, prompt, and questions
ad_account_idstringObligatorio
The ID of the ad account to create the lead gen form under (format: a2_xxxxx or t2_xxxxx)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Reddit PostREDDIT_ADS_CREATE_POSTAcción

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

Parámetros de entrada

dataobjectObligatorio
Post data containing type, headline, body, and optional configuration parameters.
profile_idstringObligatorio
The ID of the profile to create a post for. Must match pattern ^t2_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Product CatalogREDDIT_ADS_CREATE_PRODUCT_CATALOGAcción

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.

Parámetros de entrada

dataobjectObligatorio
The product catalog data object containing name, language, currency, and optional event sources.
business_idstringObligatorio
The ID of the parent business.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Product FeedREDDIT_ADS_CREATE_PRODUCT_FEEDAcción

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

Parámetros de entrada

dataobjectObligatorio
The product feed data object containing URL, mode, and optional authentication credentials.
catalog_idstringObligatorio
The ID of the parent product catalog.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Product SetREDDIT_ADS_CREATE_PRODUCT_SETAcción

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.

Parámetros de entrada

dataobjectObligatorio
The product set data object containing name and filter rule.
catalog_idstringObligatorio
The ID of the parent product catalog.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Saved AudienceREDDIT_ADS_CREATE_SAVED_AUDIENCEAcción

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

Parámetros de entrada

dataobjectObligatorio
Saved audience configuration including name, type, and targeting parameters
ad_account_idstringObligatorio
The ID of the ad account to create the saved audience under (format: 'a2_...')

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Structured Post Creation JobREDDIT_ADS_CREATE_STRUCTURED_POST_CREATION_JOBAcción

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

Parámetros de entrada

dataobjectObligatorio
Structured post data containing creative content and optional settings.
profile_idstringObligatorio
The ID of the profile to create a post for. Must match pattern ^t2_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Custom AudienceREDDIT_ADS_DELETE_CUSTOM_AUDIENCEAcción

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.

Parámetros de entrada

audience_idstringObligatorio
The ID of the custom audience to delete. This is the unique identifier returned when creating a custom audience.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Product CatalogREDDIT_ADS_DELETE_PRODUCT_CATALOGAcción

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.

Parámetros de entrada

catalog_idstringObligatorio
The ID of the product catalog to delete. This is the unique identifier for the catalog.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Product FeedREDDIT_ADS_DELETE_PRODUCT_FEEDAcción

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.

Parámetros de entrada

feed_idstringObligatorio
The ID of the product feed to delete. This is the unique identifier for the feed.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Batch Delete ProductsREDDIT_ADS_DELETE_PRODUCTSAcción

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.

Parámetros de entrada

datastring[]Obligatorio
List of product IDs to delete from the catalog. Minimum 1 product, maximum 1000 products per request.
catalog_idstringObligatorio
The ID of the product catalog to delete products from.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Product SetREDDIT_ADS_DELETE_PRODUCT_SETAcción

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.

Parámetros de entrada

product_set_idstringObligatorio
The ID of the product set to delete. This is the unique identifier for the product set.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Validate GeolocationsREDDIT_ADS_DO_GEOLOCATION_VALIDATIONSAcción

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.

Parámetros de entrada

citiesstring[]
List of city identifiers to validate for ad targeting. Mutually exclusive with geolocation_ids parameter.
geolocation_idsstring[]
List of geolocation IDs to validate. These are location identifiers used for ad targeting (e.g., 'US', 'CA', 'GB'). Mutually exclusive with cities parameter.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Do Keyword ValidationsREDDIT_ADS_DO_KEYWORD_VALIDATIONSAcción

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.

Parámetros de entrada

dataobjectObligatorio
Container object containing the array of keywords to validate.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate Inspiration Creative SummaryREDDIT_ADS_GENERATE_INSPIRATION_CREATIVE_SUMMARYAcción

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.

Parámetros de entrada

inspiration_creative_idstringObligatorio
The ID of the inspiration creative to generate summary for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Ad Account by IDREDDIT_ADS_GET_AD_ACCOUNTAcción

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

Parámetros de entrada

ad_account_idstringObligatorio
The ID of the ad account to get. Must match pattern ^(t2|a2)_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ad account historyREDDIT_ADS_GET_AD_ACCOUNT_HISTORYAcción

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.

Parámetros de entrada

dataobject
Data payload for ad account history request.
page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use this for pagination to get subsequent pages of results.
ad_account_idstringObligatorio
The ID of the ad account to get the account history for (e.g., 'a2_imh76hh7e126').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Ad GroupREDDIT_ADS_GET_AD_GROUPAcción

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

Parámetros de entrada

ad_group_idstringObligatorio
The ID of the ad group to get.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get App Last Fired At ReportREDDIT_ADS_GET_APP_LAST_FIRED_ATAcción

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

Parámetros de entrada

app_idstringObligatorio
The ID of the app to get the last fired at report. This is typically the app's bundle identifier (e.g., 'com.reddit.frontpage' for Android or iOS apps).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get A ReportREDDIT_ADS_GET_A_REPORTAcción

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.

Parámetros de entrada

dataobjectObligatorio
The report data parameters including time range, fields, and optional breakdowns.
page.sizeinteger
The number of items to be returned by page.
page.tokenstring
The token for the page to retrieve. Used for pagination.
ad_account_idstringObligatorio
The ID of the ad account to get the ads report under. Example: 'a2_imh76hh7e126'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Business by IDREDDIT_ADS_GET_BUSINESSAcción

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.

Parámetros de entrada

business_idstringObligatorio
The ID of the business to get. This endpoint requires the member to have memberships to the business.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Campaign by IDREDDIT_ADS_GET_CAMPAIGNAcción

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.

Parámetros de entrada

campaign_idstringObligatorio
The ID of the campaign to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Channel Planning ReachREDDIT_ADS_GET_CHANNEL_PLANNING_REACHAcción

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.

Parámetros de entrada

genderstringenum
Gender for targeting.
MALEFEMALEALL
max_ageinteger
The maximum age for targeting. Must be greater than min_age. Defaults to 99 if not specified. 99 represents ages 99 and older.
min_ageinteger
The minimum age for targeting. Must be less than max_age. Defaults to 18 if not specified.
page_sizeinteger
The number of items to be returned by page. Used for pagination.
page_tokenstring
The token for the page to retrieve. Used for pagination.
geolocationstringObligatorioenum
The country code for targeting. Supported values: US (United States), CA (Canada), GB (United Kingdom).
USCAGB
duration_daysintegerObligatorioenum
Number of days in the reach prediction window. Must be either 7 or 28 days.
728

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Child Funding InstrumentsREDDIT_ADS_GET_CHILD_FUNDING_INSTRUMENTSAcción

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.

Parámetros de entrada

page.sizeinteger
The number of items to be returned per page
page.tokenstring
The token for the page to retrieve. Use this to fetch subsequent pages of results
funding_instrument_idstringObligatorio
The ID of the parent funding instrument to retrieve allocations for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Custom AudienceREDDIT_ADS_GET_CUSTOM_AUDIENCEAcción

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

Parámetros de entrada

audience_idstringObligatorio
The ID of the custom audience to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Lead Gen Form by IDREDDIT_ADS_GET_LEAD_GEN_FORMAcción

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

Parámetros de entrada

lead_gen_form_idstringObligatorio
The ID of the form to retrieve. Format: UUID (e.g., '346ac343-fbb3-4738-82db-70828af30648').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Authenticated MemberREDDIT_ADS_GET_MEAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Pixel Last Fired At ReportREDDIT_ADS_GET_PIXEL_LAST_FIRED_ATAcción

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

Parámetros de entrada

pixel_idstringObligatorio
The ID of the pixel to get the report.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Post by IDREDDIT_ADS_GET_POSTAcción

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

Parámetros de entrada

post_idstringObligatorio
The ID of the promoted post to get. Must match pattern ^t3_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Product CatalogREDDIT_ADS_GET_PRODUCT_CATALOGAcción

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

Parámetros de entrada

catalog_idstringObligatorio
The ID of the product catalog.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Product FeedREDDIT_ADS_GET_PRODUCT_FEEDAcción

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.

Parámetros de entrada

feed_idstringObligatorio
The ID of the product feed.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Product SetREDDIT_ADS_GET_PRODUCT_SETAcción

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

Parámetros de entrada

product_set_idstringObligatorio
The ID of the product set.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Profile by IDREDDIT_ADS_GET_PROFILEAcción

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

Parámetros de entrada

profile_idstringObligatorio
The ID of the profile to get. Must match pattern ^t2_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Saved AudienceREDDIT_ADS_GET_SAVED_AUDIENCEAcción

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

Parámetros de entrada

saved_audience_idstringObligatorio
The ID of the saved audience to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get SKAdNetwork AvailabilityREDDIT_ADS_GET_SK_AD_NETWORK_AVAILABILITYAcción

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.

Parámetros de entrada

app_idstringObligatorio
App ID from the iOS App Store. Only providing the iOS app ID will return the SKAN campaign_quota for the given app ID.
ad_group_idstring
The ad group ID. Required when querying SKAN ad_quota for a specific ad group within the specified app ID.
campaign_idstring
Campaign ID. Required when querying SKAN ad_group_quota for a given campaign ID.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Structured Post by IDREDDIT_ADS_GET_STRUCTURED_POSTAcción

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

Parámetros de entrada

post_idstringObligatorio
The ID of the post to retrieve. Must match pattern ^t3_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List 3rd Party AudiencesREDDIT_ADS_LIST3RD_PARTY_AUDIENCESAcción

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.

Parámetros de entrada

page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Ad Accounts By BusinessREDDIT_ADS_LIST_AD_ACCOUNTS_BY_BUSINESSAcción

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

Parámetros de entrada

idsstring
IDs of ad accounts to search for within the business. Ad accounts should be comma-separated
page_sizeinteger
The number of items to be returned by page
page_tokenstring
The token for the page to retrieve
business_idstringObligatorio
The ID of the business to get ad accounts for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Ad GroupsREDDIT_ADS_LIST_AD_GROUPSAcción

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.

Parámetros de entrada

idstring[]
The list of ad group IDs to filter by.
page_sizeinteger
The number of items to be returned per page.
page_tokenstring
The token for the page to retrieve (for pagination).
campaign_idstring
The ID of the campaign to list ad groups under.
ad_account_idstringObligatorio
The ID of the ad account to list ad groups for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List AdsREDDIT_ADS_LIST_ADSAcción

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.

Parámetros de entrada

idstring[]
Optional list of specific ad IDs to filter by. When provided, only ads matching these IDs will be returned.
page.sizeinteger
Number of ads to return per page. Controls pagination size for the results.
page.tokenstring
Token for retrieving a specific page of results. Use the token from the pagination.next_url or pagination.previous_url to navigate through pages.
ad_account_idstringObligatorio
The ID of the ad account to list ads for. This is the unique identifier for the Reddit Ads account.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CampaignsREDDIT_ADS_LIST_CAMPAIGNSAcción

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.

Parámetros de entrada

idstring[]
The list of campaign IDs to filter by. If provided, only campaigns with matching IDs will be returned.
page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.
ad_account_idstringObligatorio
The ID of the ad account to list campaigns for. This is a required path parameter.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CarriersREDDIT_ADS_LIST_CARRIERSAcción

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.

Parámetros de entrada

page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Catalog ImportsREDDIT_ADS_LIST_CATALOG_IMPORTSAcción

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

Parámetros de entrada

feed_idsstring[]
List of product feed IDs to filter by.
statusesstring[]
Catalog import statuses to filter by.
page_sizeinteger
The number of items to be returned by page.
catalog_idstringObligatorio
The ID of the parent product catalog.
page_tokenstring
The token for the page to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CommunitiesREDDIT_ADS_LIST_COMMUNITIESAcción

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.

Parámetros de entrada

namesstring
Comma-separated list of community names to get info for. Queried community won't be in response if it is not targetable.
page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Communities SuggestionsREDDIT_ADS_LIST_COMMUNITIES_SUGGESTIONSAcción

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.

Parámetros de entrada

namesstring
Comma-separated list of community names to get info for. If query is not provided, it will return a set of default suggestions.
page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.
website_urlstring
The website that suggestions should relate to. If parameter is empty or not included, it will use the user's business website.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List DevicesREDDIT_ADS_LIST_DEVICESAcción

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.

Parámetros de entrada

page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Funding InstrumentsREDDIT_ADS_LIST_FUNDING_INSTRUMENTSAcción

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

Parámetros de entrada

modestringenum
Enum for funding instrument modes.
ACTIVEINACTIVEUPCOMINGSELECTABLEALL
typesstring[]
A list of funding instrument types to filter by.
searchstring
Search text to filter funding instruments by name or other text fields.
end_timestring
End time in ISO-8601 format to filter funding instruments.
page_sizeinteger
The number of items to return per page.
page_tokenstring
The pagination token for retrieving the next page of results. Obtained from the previous response's pagination.next_url.
start_timestring
Start time in ISO-8601 format to filter funding instruments.
ad_account_idstringObligatorio
The ID of the ad account to list funding instruments for.
is_selectableboolean
Deprecated parameter. Use mode=SELECTABLE or mode=ALL instead.
funding_instrument_idsstring[]
A list of funding instrument IDs to filter by.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List GeolocationsREDDIT_ADS_LIST_GEOLOCATIONSAcción

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.

Parámetros de entrada

countrystring
The filter for retrieving all geolocations by country.
postal_codestring
The filter for retrieving postal code geolocations by substring match.
cities_searchstring
The filter for retrieving city geolocations by substring match.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List IndustriesREDDIT_ADS_LIST_INDUSTRIESAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List InterestsREDDIT_ADS_LIST_INTERESTSAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Lead Gen FormsREDDIT_ADS_LIST_LEAD_GEN_FORMSAcción

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

Parámetros de entrada

page_sizeinteger
The number of items to return per page. Use to control pagination size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.
ad_account_idstringObligatorio
The ID of the ad account to list lead gen forms for. Format: a2_<identifier> (e.g., 'a2_imh76hh7e126').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List My BusinessesREDDIT_ADS_LIST_MY_BUSINESSESAcción

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

Parámetros de entrada

rolestringenum
Enum for business role types
BUSINESS_ADMINCATALOG_ADMIN
page_sizeinteger
The number of items to be returned by page.
page_tokenstring
The token for the page to retrieve.
ad_account_idstring
Optional ad account ID to filter businesses by. If provided, will return businesses that give the member access to the ad account.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Pixels By Ad AccountREDDIT_ADS_LIST_PIXELS_BY_AD_ACCOUNTAcción

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

Parámetros de entrada

page.sizeinteger
The number of items to be returned per page.
page.tokenstring
The token for the page to retrieve. Use the value from pagination.next_url or pagination.previous_url in a previous response to navigate pages.
ad_account_idstringObligatorio
The ID of the ad account to list pixels for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Pixels by BusinessREDDIT_ADS_LIST_PIXELS_BY_BUSINESSAcción

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.

Parámetros de entrada

page_sizeinteger
The number of items to be returned by page (must be ≥ 1).
page_tokenstring
The token for the page to retrieve. Use this for pagination.
business_idstringObligatorio
The ID of the business to list pixels for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Posts by ProfileREDDIT_ADS_LIST_POSTSAcción

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

Parámetros de entrada

typestringenum
The type of posts to be fetched.
CAROUSELIMAGETEXTVIDEO
sourcestringenum
The source of posts to be fetched.
ORGANICPROMOTED
page_sizeinteger
The number of items to be returned per page. Maximum 1,000 posts can be retrieved.
page_tokenstring
The token for the page to retrieve. Use the next_url or previous_url from pagination response to navigate pages.
profile_idstringObligatorio
The ID of the profile to list posts for. Must match pattern ^t2_.*

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Product CatalogsREDDIT_ADS_LIST_PRODUCT_CATALOGSAcción

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

Parámetros de entrada

business_idstringObligatorio
The ID of the parent business.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Product FeedsREDDIT_ADS_LIST_PRODUCT_FEEDSAcción

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.

Parámetros de entrada

catalog_idstringObligatorio
The ID of the parent product catalog.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Product SetsREDDIT_ADS_LIST_PRODUCT_SETSAcción

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

Parámetros de entrada

page_sizeinteger
The number of items to be returned per page.
catalog_idstringObligatorio
The ID of the parent product catalog.
page_tokenstring
The token for the page to retrieve (for pagination).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Products In Product CatalogREDDIT_ADS_LIST_PRODUCTS_IN_PRODUCT_CATALOGAcción

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.

Parámetros de entrada

idsstring[]
Optional list of specific product IDs to filter by. When provided, only products matching these IDs will be returned.
searchstring
Search query to filter products by title, description, or other text fields.
page.sizeinteger
Number of products to return per page. Controls pagination size for the results.
catalog_idstringObligatorio
The ID of the product catalog to list products from.
page.tokenstring
Token for retrieving a specific page of results. Use the token from pagination.next_url or pagination.previous_url to navigate through pages.
approval_decisionstringenum
Enum for product approval decisions in Reddit Ads.
PENDINGAPPROVEDREJECTED

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Products In Product SetREDDIT_ADS_LIST_PRODUCTS_IN_PRODUCT_SETAcción

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.

Parámetros de entrada

idsstring[]
Optional list of specific product IDs to filter by. When provided, only products matching these IDs will be returned.
searchstring
Search query to filter products by title, description, or other text fields.
page.sizeinteger
Number of products to return per page. Controls pagination size for the results.
issue_codestringenum
Enum for product issue codes that can be used to filter products.
INVALID_ADDITIONAL_IMAGE_LINKSINVALID_SALE_PRICEINVALID_SALE_PRICE_EFFECTIVE_DATEINVALID_EXPIRATION_DATEIMAGE_PROCESSING_ERRORIMAGE_REJECTEDLOW_IMAGE_QUALITYINVALID_CUSTOM_LABEL_0INVALID_CUSTOM_LABEL_1INVALID_CUSTOM_LABEL_2INVALID_CUSTOM_LABEL_3INVALID_CUSTOM_LABEL_4+30
page.tokenstring
Token for retrieving a specific page of results. Use the token from pagination.next_url or pagination.previous_url to navigate through pages.
product_set_idstringObligatorio
The ID of the product set to list products from.
approval_decisionstringenum
Enum for product approval decisions in Reddit Ads.
PENDINGAPPROVEDREJECTED

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Profiles By Ad AccountREDDIT_ADS_LIST_PROFILES_BY_AD_ACCOUNTAcción

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

Parámetros de entrada

page_sizeinteger
The number of items to be returned per page. Must be between 1 and 100.
page_tokenstring
The token for the page to retrieve. Use the next_url or previous_url from pagination response to navigate pages.
ad_account_idstringObligatorio
The ID of the ad account to list profiles for. Example: 'a2_imh76hh7e126'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Profiles By BusinessREDDIT_ADS_LIST_PROFILES_BY_BUSINESSAcción

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.

Parámetros de entrada

page_sizeinteger
The number of items to be returned by page. Must be at least 1.
page_tokenstring
The token for the page to retrieve. Use this to navigate to the next or previous page of results.
business_idstringObligatorio
The ID of the business to list profiles for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Saved AudiencesREDDIT_ADS_LIST_SAVED_AUDIENCESAcción

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

Parámetros de entrada

page_sizeinteger
The number of items to be returned by page. Must be a positive integer.
page_tokenstring
The token for the page to retrieve. Use this for pagination to fetch subsequent pages.
ad_account_idstringObligatorio
The ID of the ad account to list saved audiences for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Structured PostsREDDIT_ADS_LIST_STRUCTURED_POSTSAcción

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.

Parámetros de entrada

idstring[]
List of specific post IDs to filter by. Returns up to 10 specific structured posts by ID owned by the profile.
typestringenum
Type of structured post.
CAROUSELIMAGETEXTVIDEO
sourcestringenum
Source of structured post.
ORGANICPROMOTED
page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.
profile_idstringObligatorio
The ID of the profile to list posts for. This is a required path parameter.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Time ZonesREDDIT_ADS_LIST_TIME_ZONESAcción

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.

Parámetros de entrada

page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List User Custom AudiencesREDDIT_ADS_LIST_USER_CUSTOM_AUDIENCESAcción

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

Parámetros de entrada

namestring
Optional field used for filtering by a specific custom audience name.
page_sizeinteger
The number of items to be returned by page.
page_tokenstring
The token for the page to retrieve.
ad_account_idstringObligatorio
The ID of the parent ad account (e.g., 'a2_imh76hh7e126').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Query Ad AccountsREDDIT_ADS_QUERY_AD_ACCOUNTSAcción

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.

Parámetros de entrada

dataobject
Filter criteria for querying ad accounts.
page_sizeinteger
The number of items to be returned by page.
page_tokenstring
The token for the page to retrieve.
business_idstringObligatorio
The ID of the business to query ad accounts for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Query funding instruments by businessREDDIT_ADS_QUERY_FUNDING_INSTRUMENTS_BY_BUSINESSAcción

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

Parámetros de entrada

dataobject
Data payload for querying funding instruments.
searchstring
A search term to filter funding instruments by name, ID, or type.
page_sizeinteger
The number of items to be returned by page.
page_tokenstring
The token for the page to retrieve.
business_idstringObligatorio
The ID of the business to query funding instruments for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Search CommunitiesREDDIT_ADS_SEARCH_COMMUNITIESAcción

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.

Parámetros de entrada

querystring
A string that will be used to query (search) for communities by name or by topics. If parameter is empty or not included, it will return all subreddits.
page_sizeinteger
The number of items to be returned per page. Controls pagination page size.
page_tokenstring
The token for the page to retrieve. Use the token from pagination.next_url to fetch the next page of results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Ad AccountREDDIT_ADS_UPDATE_AD_ACCOUNTAcción

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.

Parámetros de entrada

dataobjectObligatorio
Ad account fields to update. Only include fields you want to modify
ad_account_idstringObligatorio
The ID of the ad account to update. Must start with 't2_' or 'a2_'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update BusinessREDDIT_ADS_UPDATE_BUSINESSAcción

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.

Parámetros de entrada

dataobjectObligatorio
The business data to update.
business_idstringObligatorio
The ID of the business to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update CampaignREDDIT_ADS_UPDATE_CAMPAIGNAcción

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

Parámetros de entrada

dataobjectObligatorio
Campaign data to update.
campaign_idstringObligatorio
The ID of the campaign to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Custom Audience UsersREDDIT_ADS_UPDATE_CUSTOM_AUDIENCE_USERSAcción

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.

Parámetros de entrada

dataobjectObligatorio
Data payload containing the action type, column schema, and user identifier data
audience_idstringObligatorio
The ID of the Custom Audience to update

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update PostREDDIT_ADS_UPDATE_POSTAcción

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

Parámetros de entrada

dataobjectObligatorio
Post metadata to update.
post_idstringObligatorio
The ID of the post to update. Must start with 't3_'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Product CatalogREDDIT_ADS_UPDATE_PRODUCT_CATALOGAcción

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.

Parámetros de entrada

dataobjectObligatorio
The catalog data to update.
catalog_idstringObligatorio
The ID of the product catalog to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Product FeedREDDIT_ADS_UPDATE_PRODUCT_FEEDAcción

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.

Parámetros de entrada

dataobjectObligatorio
The product feed data to update.
feed_idstringObligatorio
The ID of the product feed to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Product SetREDDIT_ADS_UPDATE_PRODUCT_SETAcción

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.

Parámetros de entrada

dataobjectObligatorio
The product set data to update.
product_set_idstringObligatorio
The ID of the product set to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Saved AudienceREDDIT_ADS_UPDATE_SAVED_AUDIENCEAcción

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

Parámetros de entrada

dataobjectObligatorio
Saved audience data to update
saved_audience_idstringObligatorio
The ID of the saved audience to update

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Structured PostREDDIT_ADS_UPDATE_STRUCTURED_POSTAcción

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

Parámetros de entrada

dataobjectObligatorio
Post metadata to update. Only allow_comments can be modified.
post_idstringObligatorio
The ID of the post to update. Must start with 't3_'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not