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 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).
Untrusted display-only summary
Get Pixel Last Fired At Report
REDDIT_ADS_GET_PIXEL_LAST_FIRED_AT
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).
Untrusted display-only summary
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 (Creative Management).
Untrusted display-only summary
Get Product Catalog
REDDIT_ADS_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).
Untrusted display-only summary
Get Product Feed
REDDIT_ADS_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.
Untrusted display-only summary
Get Product Set
REDDIT_ADS_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).
Untrusted display-only summary
Get Profile by ID
REDDIT_ADS_GET_PROFILE
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).
Untrusted display-only summary
Get Saved Audience
REDDIT_ADS_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).
Untrusted display-only summary
Get SKAdNetwork Availability
REDDIT_ADS_GET_SK_AD_NETWORK_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.
Untrusted display-only summary
Get Structured Post by ID
REDDIT_ADS_GET_STRUCTURED_POST
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).
Untrusted display-only summary
List 3rd Party Audiences
REDDIT_ADS_LIST3RD_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.
Untrusted display-only summary
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 for large result sets. Rate limit: Campaign Management Read (400 requests/60s).
Untrusted display-only summary
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: Campaign Management Read - 400 requests per 60 seconds.
Untrusted display-only summary
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 for large result sets.
Untrusted display-only summary
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: Campaign Management Read - 400 requests per 60 seconds.
Untrusted display-only summary
List Carriers
REDDIT_ADS_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.
Untrusted display-only summary
List Catalog Imports
REDDIT_ADS_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).
Untrusted display-only summary
List Communities
REDDIT_ADS_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.
Untrusted display-only summary
List Communities Suggestions
REDDIT_ADS_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.
Untrusted display-only summary
List Devices
REDDIT_ADS_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.
Untrusted display-only summary
List Funding Instruments
REDDIT_ADS_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).
Untrusted display-only summary
List Geolocations
REDDIT_ADS_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.
Untrusted display-only summary
List Industries
REDDIT_ADS_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.
Untrusted display-only summary
List Interests
REDDIT_ADS_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.
Untrusted display-only summary
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 (Leads category).
Untrusted display-only summary
List My Businesses
REDDIT_ADS_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).
Untrusted display-only summary
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. Note: Rate limited to 30 requests per 60 seconds (Conversion Signals).
Untrusted display-only summary
List Pixels by Business
REDDIT_ADS_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.
Untrusted display-only summary
List Posts by Profile
REDDIT_ADS_LIST_POSTS
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).
Untrusted display-only summary
List Product Catalogs
REDDIT_ADS_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).
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.