Reddit Ads API for managing advertising campaigns, conversions, and account data on Reddit.
Description is untrusted, display-only upstream metadata. It never becomes policy, OAuth scope authority, or an agent instruction.
Pakkawork boundary
Research catalogue metadata only. No Pakkawork OAuth, credential, host, quota, executor, or verifier is enabled.
No Pakkawork execution adapter is enabled. Hosted account-authorisation availability is workspace-specific and checked separately in the dashboard.Check workspace connection options
Only field names, types, and required markers are shown. Secret values, default auth URLs, credential material, and inferred OAuth scopes are excluded.
OAUTH2 · managed upstream
OAUTH2
reddit_ads_oauth
Upstream managed
Developer setup
Client idclient_id · stringRequired
Client secretclient_secret · stringRequired
User-Agentuser_agent · stringRequired
Redirect URIoauth_redirect_uri · stringOptional
Scopesscopes · stringOptional
User connection
No fields declared in this snapshot.
Capability index
Actions and trigger definitions
Static summaries are available. Live schemas remain disabled until PROVIDER_HUB_API_KEY is configured server-side.
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.
Untrusted display-only summary
List Product Sets
REDDIT_ADS_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).
Untrusted display-only summary
List Products In Product Catalog
REDDIT_ADS_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.
Untrusted display-only summary
List Products In Product Set
REDDIT_ADS_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.
Untrusted display-only summary
List Profiles By Ad Account
REDDIT_ADS_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).
Untrusted display-only summary
List Profiles By Business
REDDIT_ADS_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.
Untrusted display-only summary
List Saved Audiences
REDDIT_ADS_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).
Untrusted display-only summary
List Structured Posts
REDDIT_ADS_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.
Untrusted display-only summary
List Time Zones
REDDIT_ADS_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.
Untrusted display-only summary
List User Custom Audiences
REDDIT_ADS_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).
Untrusted display-only summary
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: Business Manager - 100 requests per 60 seconds.
Untrusted display-only summary
Query funding instruments by business
REDDIT_ADS_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).
Untrusted display-only summary
Search Communities
REDDIT_ADS_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.
Untrusted display-only summary
Update Ad Account
REDDIT_ADS_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.
Untrusted display-only summary
Update Business
REDDIT_ADS_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.
Untrusted display-only summary
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 (Campaign Management Write).
Untrusted display-only summary
Update Custom Audience Users
REDDIT_ADS_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.
Untrusted display-only summary
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 (Creative Management).
Untrusted display-only summary
Update Product Catalog
REDDIT_ADS_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.
Untrusted display-only summary
Update Product Feed
REDDIT_ADS_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.
Untrusted display-only summary
Update Product Set
REDDIT_ADS_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.
Untrusted display-only summary
Update Saved Audience
REDDIT_ADS_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).
Untrusted display-only summary
Update Structured Post
REDDIT_ADS_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).
Untrusted display-only summary
Provenance
Versioned facts, explicit trust.
The detail snapshot comes from an attributed MIT-licensed repository revision. Safe local icons use exact-match CC0 Simple Icons symbols; unmatched brands use monograms.