Connect Reddit Ads

Written By Christopher Scaminaci

Last updated 6 days ago

Reddit Ads is Reddit's advertising platform, exposed to StackJack through the Reddit Ads API (v3). It covers the full campaign structure — businesses, ad accounts, campaigns, ad groups, and ads — plus product catalogs, audiences, conversion pixels, reporting, targeting discovery, and lead-generation-form records during Reddit's 2026 onsite-form transition.

Connecting Reddit Ads to StackJack gives your AI assistant a broad family of reddit_ MCP tools — MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

Inventory your businesses, ad accounts, funding instruments, profiles, and the whole campaign → ad group → ad tree
Report on performance and pull ad-account change history
Plan targeting — browse communities, interests, geolocations, devices, carriers, and languages, and get keyword and bid suggestions
Manage (on Pro plans) campaigns, ad groups, ads, posts, product catalogs/feeds/sets, and custom/saved audiences
Measure (on Pro plans) — send server-side conversion events through the Conversions API and submit privacy data-deletion jobs

How StackJack authenticates to Reddit Ads

Reddit Ads uses OAuth with your own Reddit Ads developer application. Rather than StackJack using a shared app, a verified Reddit business administrator creates an app in Ads Manager → Business → Developer Portal, enters its app ID and secret in StackJack, and completes authorization with a Reddit account that can reach the required businesses and ad accounts. The resulting connection is shared across your StackJack organization; team members do not each connect individually.

The connection inherits exactly the authorizing Reddit account's access. Everything your AI can see or change in Reddit Ads is bounded by what that account can do and by the scopes approved on Reddit's consent screen. StackJack requests only the union its shipping tools use: adsread, adsedit, adsconversions, adsleadgendownloader, adsmeasurement:read, adsmeasurement:write, and adsdatadeletion. The first six are listed in Reddit's current authentication guide; Reddit's separate Data Deletion guide requires adsdatadeletion. A 403 from a tool means the authorizing account, product entitlement, or approved scopes do not cover that action.

Reddit reports an access token's lifetime in expires_in and currently documents either 3,600 seconds (one hour) or 86,400 seconds (one day). StackJack requests duration=permanent, stores the resulting refresh token, and renews access automatically based on the returned lifetime. There is normally nothing to refresh manually, but you must re-authorize if the Reddit user revokes access, a business administrator deletes the app, the app secret changes, Reddit invalidates the grant, or your connection predates a newly required scope.

Before you begin

In StackJack: you need a role that can manage connectors (tenant Owner, a co-owner, or an Administrator).
In Reddit: a verified account that is a business administrator for the relevant Reddit Ads business. Only verified business admins can create or manage Ads API applications.
Callback URL: keep the StackJack setup drawer open so you can copy its exact redirect URI. Even a small mismatch causes authorization to fail.

Step 1 — Create a Reddit app

Sign in to Reddit Ads Manager as a verified business administrator.
In Ads Manager, open Business → Developer Portal. Reddit's Create a Developer Application guide shows the current interface and field requirements.
Choose Add Apps → Create an app. Enter a descriptive app name, an About URL, and a business-admin primary contact.
Set Redirect URL to the exact callback URL shown in the StackJack Reddit Ads setup drawer.
Choose Create App, then copy the generated app ID and app secret. Store the secret in your password manager until you have completed StackJack setup.

Step 2 — Add the credentials and authorize in StackJack

In the StackJack portal, open Connectors.
Select the Reddit Ads card. Choose How To Connect for the inline checklist or Configure to enter credentials.
Paste the Reddit app ID and secret.
Choose Authorize. StackJack sends you to Reddit with the callback URI and the seven scopes listed above. Review them before approving; StackJack does not request unrelated Reddit-account scopes.
Review the Reddit consent screen and approve it with the intended business account. Reddit redirects you back to StackJack, where the connection is validated.

What happens when you authorize

The app ID, secret, and resulting refresh token are stored encrypted in Azure Key Vault — never in the StackJack database and never shown back to you.
If this is the first time you configure Reddit Ads, a Free-tier subscription for the connector is created automatically so its Free tools work right away.
StackJack validates without changing Reddit data by making an authenticated GET /me request.
The drawer remains the source of truth for connection state. A successful probe shows Connected. A failed probe preserves the credential and shows Needs Attention with an upstream reason and a Re-test action.

Organization-wide, not per-member

Reddit's authorization is inherently tied to one Reddit account, so StackJack treats Reddit Ads as an organization-wide connection completed once by an administrator. There is no per-member Reddit sign-in — once an admin has authorized it, the connector is available to everyone in your organization with access. Team members do not connect Reddit Ads individually on the My Connectors page.

Lead Generation Forms transition

Reddit has announced that the onsite Lead Generation Forms API will be sunset on September 21, 2026, while its GET and LIST endpoints remain available to retain existing form records. Reddit also says existing ads that use onsite forms will be paused on September 30, 2026. Before those dates:

Export or otherwise retain the onsite form records you need with the Reddit Ads read tools.
Move new lead capture to an offsite form.
Measure the replacement flow with Reddit Pixel, the Conversions API, or both.
Re-authorize StackJack if this Reddit Ads connection was established before adsleadgendownloader and the measurement scopes were added to the consent request. OAuth does not add scopes to an existing grant automatically.

Do not build new long-lived workflows around reddit_create_lead_gen_form; Reddit has scheduled that API surface for retirement.

Working with the campaign structure

Reddit's resources form a tree: businesses → ad accounts → campaigns → ad groups → ads, with product catalogs, audiences, pixels, and lead-gen forms hanging off ad accounts and businesses. Start with reddit_list_my_businesses to discover business IDs, then drill down with reddit_list_ad_accounts_by_business and the campaign/ad-group/ad list tools. The targeting-discovery tools (communities, interests, geolocations, and the rest) supply the IDs you use when creating ad groups or saved audiences.

Large lists are returned a page at a time. Each response carries a pagination.next_url; the part you need is its page.token value, which is an opaque cursor. Pass that token into the next call's pageToken and StackJack sends it back verbatim as the page.token query parameter. Do not pass the whole next_url, and do not reuse a token from a different tool or a different filter set — a cursor is only meaningful to the query that produced it. Omit pageToken to restart at the first page. Page size is capped at 1,000, with tighter per-endpoint limits on some lists.

Plans and available tools

Free includes reads across businesses, ad accounts, campaigns, ad groups, ads, posts, product catalogs, audiences, pixels, and reporting, plus targeting discovery and query/validation lookups.
Pro adds create/update/delete operations for campaigns, ad groups, ads, posts, product catalogs/feeds/sets and their products, and custom/saved audiences — plus the Conversions API and privacy data-deletion jobs. A lead-form create tool remains present only for Reddit's pre-sunset transition window; do not depend on it for new long-lived workflows.
Business offers the same tool set as Pro with a higher monthly call quota.

See the generated Reddit Ads tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.

Current pricing and quotas are shown in the portal's Billing page and at checkout.

Safety note. A handful of Pro tools are irreversible or high-impact, and StackJack marks them destructive: deleting a custom audience, product catalog, product feed, or product set; batch-deleting catalog products; and submitting a data-deletion job (a permanent, right-to-erasure request). Whether your AI application asks you to confirm before running one depends on that application's own settings — see Destructive tools and confirmation. Review those settings, and scope your AI's access deliberately — use the tool selections on the MCP Setup page and the Permissions page to enable only the actions you want an AI to take.

Rate limits

Reddit publishes endpoint-group quotas, not one account-wide number. Examples include 400 campaign-management reads per 60 seconds, 200 campaign-management writes per 60 seconds, 100 targeting-taxonomy calls per 60 seconds, 60 reporting calls per 60 seconds, and lower limits for funding, leads, forecasting, and privacy endpoints. Reddit reports the applicable policy and remaining capacity in RateLimit-Policy and RateLimit response headers; the Conversions API has separate limits and does not return those standard headers.

StackJack also applies an aggregate per-tenant pace of about 100 requests per minute and records 429 backoff. That guard does not replace Reddit's lower endpoint-specific limits, so a busy workflow can still be throttled. Let the client retry after the indicated delay and avoid launching overlapping full-account crawls. See Reddit's current rate-limit table for the authoritative group assignments and quotas.

Rotating or replacing the credentials

The Reddit app ID and secret, plus the account authorization, are the recovery secret. If you rotate the app secret in Reddit, delete the app, revoke the authorization, or need scopes added after the original consent, open Connectors → Reddit Ads → Configure, enter the current app ID and secret, and complete Authorize again. Re-testing alone cannot enlarge an existing OAuth grant.

Deleting a developer app in Reddit is irreversible and disconnects every service using that app. Prefer creating a replacement, updating StackJack, and confirming the new connection before deleting the old app.

Disconnecting Reddit Ads

Use Disconnect in the Reddit Ads drawer to remove StackJack's stored app credentials and OAuth authorization and stop future Reddit Ads API calls. Disconnecting StackJack does not delete the developer app in Reddit or undo campaigns, audiences, catalog changes, conversions, or privacy jobs already submitted. Remove or delete the app separately in Reddit only if you intend to revoke it for every integration that uses it.

For a Free subscription, the confirmation can also remove Reddit Ads tools from tool lists. A paid connector plan remains separate billing state; use Manage on Billing on the connector card if you also want to end it — it opens this connector's removal dialog on the Billing page. A legacy website subscription reads Cancel Plan instead.

Troubleshooting

Symptom	Likely cause	What to do
You cannot see Developer Portal	The Reddit account is not both verified and a business administrator	Ask a verified business admin to create/manage the app under Business → Developer Portal
Authorization fails or loops back with an error	The app's redirect URL does not exactly match the callback URL shown in StackJack	Correct Business → Developer Portal → app → Redirect URL, then authorize again
Needs Attention appears right after authorization	The app ID/secret is wrong, the grant was not completed, or the authorizing user cannot call `/me`	Confirm the app in Developer Portal, update the values in Configure, authorize again, then use Re-test
Tools worked, then started failing with `invalid_grant`	The app was deleted, access was revoked, or Reddit invalidated the refresh token	Confirm the app still exists in Business → Developer Portal, then reconnect through Configure → Authorize
Lead-form or measurement tools return 403 while ordinary reads work	The connection predates `adsleadgendownloader` or the measurement scopes, or the account lacks the product access	Complete Configure → Authorize again and approve the current scope set; Re-test alone cannot change consent
One tool returns a 403 while others succeed	The authorizing account, product entitlement, or approved scopes do not cover that action	Confirm the user has access, then re-authorize and approve the current scope set
Conversions or data-deletion tools return a permissions error	Those features require `adsconversions` / `adsdatadeletion` and, for conversions, acceptance of Reddit's Advertiser Measurement Program terms	Re-authorize and accept the measurement terms in Reddit
A later page fails with a pagination or page-token error	The cursor is stale, or it came from a different tool or a different filter set	Re-run the same list tool with the same filters and pass the `page.token` value from its immediately prior response as `pageToken`; omit it to restart at page one
Calls return 429 while other Reddit tools still work	The endpoint group's quota was exhausted	Wait for the reset/backoff, reduce concurrent crawls, and consult Reddit's `RateLimit` headers and endpoint-group table
Write tools missing from your AI's tool list	Connector is on the Free tier, or the tools aren't selected for your client	Upgrade the Reddit Ads connector plan and check your tool selections on the MCP Setup page

Reddit Ads tools

reddit_ · 102 tools · Free 70 · Pro 32

Businesses

Tool	What it does
`reddit_get_business` Free · Read-only	Get a single Reddit Ads business by its business id.
`reddit_list_industries` Free · Read-only	List the industry taxonomy Reddit Ads uses to classify businesses.
`reddit_list_my_businesses` Free · Read-only	List the Reddit Ads businesses the authorizing account can access.
`reddit_update_business` Pro · Write	Update a Reddit Ads business identified by businessId.

Members

Tool	What it does
`reddit_get_feature_access` Free · Read-only	Get the feature-access flags for the authorizing account — which Reddit Ads features (e.g. product catalogs, lead-gen, conversions) are enabled.
`reddit_get_me` Free · Read-only	Get the Reddit account that authorized this connector (the /me endpoint).

Ad Accounts

Tool	What it does
`reddit_get_ad_account` Free · Read-only	Get a single ad account by its ad account id.
`reddit_get_ad_account_history` Free · Read-only	Get the change history (audit log) for an ad account (a read; POST is used only because the date range and paging ride the request body).
`reddit_list_ad_accounts_by_business` Free · Read-only	List the ad accounts under a business (by businessId).
`reddit_query_ad_accounts` Free · Read-only	Query the ad accounts under a business with a filter/paging body (a read; POST is used only because the criteria ride the request body).
`reddit_update_ad_account` Pro · Write	Update an ad account identified by adAccountId.

Funding Instruments

Tool	What it does
`reddit_get_child_funding_instruments` Free · Read-only	Get the child funding instruments (allocations) under a parent funding instrument (by fundingInstrumentId).
`reddit_list_funding_instruments` Free · Read-only	List the funding instruments (payment methods) on an ad account.
`reddit_query_funding_instruments_by_business` Free · Read-only	Query the funding instruments across a business with a filter/paging body (a read; POST is used only because the criteria ride the request body).

Profiles

Tool	What it does
`reddit_get_profile` Free · Read-only	Get a single profile by its profile id.
`reddit_list_profiles_by_ad_account` Free · Read-only	List the profiles (the Reddit accounts/pages ads run under) available to an ad account.
`reddit_list_profiles_by_business` Free · Read-only	List the profiles available to a business (by businessId).

Campaigns

Tool	What it does
`reddit_create_campaign` Pro · Destructive	Create a campaign in an ad account (by adAccountId).
`reddit_get_campaign` Free · Read-only	Get a single campaign by its campaign id.
`reddit_list_campaigns` Free · Read-only	List the campaigns in an ad account (by adAccountId).
`reddit_update_campaign` Pro · Destructive	Update a campaign identified by campaignId (e.g. rename, pause/resume via configured_status, change objective settings).

Ad Groups

Tool	What it does
`reddit_create_ad_group` Pro · Destructive	Create an ad group in an ad account (by adAccountId).
`reddit_get_ad_group` Free · Read-only	Get a single ad group by its ad group id.
`reddit_list_ad_groups` Free · Read-only	List the ad groups in an ad account (by adAccountId).
`reddit_update_ad_group` Pro · Destructive	Update an ad group identified by adGroupId (e.g. change bid, budget, schedule, targeting, or pause/resume via configured_status).

Tool	What it does
`reddit_create_ad` Pro · Destructive	Create an ad in an ad account (by adAccountId).
`reddit_get_ad` Free · Read-only	Get a single ad by its ad id.
`reddit_list_ads` Free · Read-only	List the ads in an ad account (by adAccountId).
`reddit_update_ad` Pro · Destructive	Update an ad identified by adId (e.g. swap the creative/post, rename, or pause/resume via configured_status).

Reports

Tool	What it does
`reddit_get_report` Free · Read-only	Run a performance report for an ad account (by adAccountId) and return the metrics (a read; POST is used only because the date range, breakdowns, metrics, and paging ride the request body).

Posts

Tool	What it does
`reddit_create_post` Pro · Write	Create a promotable post under a profile (profile id from reddit_list_profiles_by_ad_account).
`reddit_create_structured_post_job` Pro · Write	Start an ASYNC job that builds a structured post under a profile (profile id from reddit_list_profiles_by_ad_account).
`reddit_get_post` Free · Read-only	Get a single promotable post by its id (from reddit_list_posts).
`reddit_get_structured_post` Free · Read-only	Get a single structured post by its id (from reddit_list_structured_posts or the completed job in reddit_get_structured_post_job).
`reddit_get_structured_post_job` Free · Read-only	Poll an async structured-post creation job by its id (returned from reddit_create_structured_post_job).
`reddit_list_posts` Free · Read-only	List the promotable posts under a profile (profile id from reddit_list_profiles_by_ad_account or reddit_list_profiles_by_business).
`reddit_list_structured_posts` Free · Read-only	List the structured posts under a profile (profile id from reddit_list_profiles_by_ad_account).
`reddit_update_post` Pro · Write	Update an existing promotable post by its id (from reddit_list_posts).
`reddit_update_structured_post` Pro · Write	Update an existing structured post by its id (from reddit_list_structured_posts).

Creative Assets

Tool	What it does
`reddit_create_creative_asset_upload` Pro · Write	Start a creative-asset upload under a profile (profile id from reddit_list_profiles_by_ad_account).
`reddit_get_creative_asset` Free · Read-only	Get a single processed creative asset by its id (from reddit_list_creative_assets).
`reddit_get_creative_asset_upload` Free · Read-only	Get the status of a single creative-asset upload by its id (returned from reddit_create_creative_asset_upload).
`reddit_list_creative_asset_uploads` Free · Read-only	Batch-fetch creative-asset uploads under a profile by their ids.
`reddit_list_creative_assets` Free · Read-only	List the processed creative assets under a profile (profile id from reddit_list_profiles_by_ad_account).

Product Catalogs

Tool	What it does
`reddit_create_product_catalog` Pro · Write	Create a product catalog under a business (business id from reddit_list_my_businesses).
`reddit_delete_product_catalog` Pro · Destructive	Permanently delete a product catalog by its id (from reddit_list_product_catalogs).
`reddit_get_catalog_import_report` Free · Read-only	Get the summary report for a catalog import run (import id from reddit_list_catalog_imports) — counts of products processed, added, updated, and failed.
`reddit_get_product_catalog` Free · Read-only	Get a single product catalog by its id (from reddit_list_product_catalogs).
`reddit_list_catalog_import_issues` Free · Read-only	List the validation issues for a catalog import run (import id from reddit_list_catalog_imports).
`reddit_list_catalog_imports` Free · Read-only	List the import runs for a product catalog (catalog id from reddit_list_product_catalogs).
`reddit_list_product_catalogs` Free · Read-only	List the product catalogs owned by a business (business id from reddit_list_my_businesses).
`reddit_update_product_catalog` Pro · Write	Update a product catalog by its id (from reddit_list_product_catalogs).

Product Feeds

Tool	What it does
`reddit_create_product_feed` Pro · Write	Create a product feed on a catalog (catalog id from reddit_list_product_catalogs).
`reddit_delete_product_feed` Pro · Destructive	Permanently delete a product feed by its id (from reddit_list_product_feeds).
`reddit_get_product_feed` Free · Read-only	Get a single product feed by its id (from reddit_list_product_feeds).
`reddit_list_product_feeds` Free · Read-only	List the product feeds attached to a catalog (catalog id from reddit_list_product_catalogs).
`reddit_update_product_feed` Pro · Write	Update a product feed by its id (from reddit_list_product_feeds).

Product Sets

Tool	What it does
`reddit_create_product_set` Pro · Write	Create a product set on a catalog (catalog id from reddit_list_product_catalogs).
`reddit_delete_product_set` Pro · Destructive	Permanently delete a product set by its id (from reddit_list_product_sets).
`reddit_get_product_set` Free · Read-only	Get a single product set by its id (from reddit_list_product_sets).
`reddit_list_product_sets` Free · Read-only	List the product sets defined on a catalog (catalog id from reddit_list_product_catalogs).
`reddit_list_products_in_set` Free · Read-only	List the products that match a product set's filter rules (set id from reddit_list_product_sets).
`reddit_update_product_set` Pro · Write	Update a product set by its id (from reddit_list_product_sets).

Products

Tool	What it does
`reddit_batch_delete_products` Pro · Destructive	Permanently remove products from a catalog in bulk (catalog id from reddit_list_product_catalogs).
`reddit_batch_upsert_products` Pro · Write	Create or update products in a catalog in bulk (catalog id from reddit_list_product_catalogs).
`reddit_list_products_in_catalog` Free · Read-only	List the products in a catalog (catalog id from reddit_list_product_catalogs).

Audiences & Measurement

Tool	What it does
`reddit_create_custom_audience` Pro · Write	Create a custom audience under an ad account.
`reddit_create_data_deletion_job` Pro · Destructive	Submit an asynchronous privacy job to delete Reddit ads data associated with user identifiers (a right-to-erasure / GDPR-style request).
`reddit_create_lead_gen_form` Pro · Write	Create a lead-generation form under an ad account.
`reddit_create_saved_audience` Pro · Write	Create a saved (reusable) targeting audience under an ad account.
`reddit_delete_custom_audience` Pro · Destructive	Permanently delete a custom audience by ID.
`reddit_get_custom_audience` Free · Read-only	Get a single custom audience by ID, including its status and size.
`reddit_get_data_deletion_job_status` Free · Read-only	Retrieve the current status of a data-deletion job (deletions are processed daily, so poll for completion).
`reddit_get_lead_gen_form` Free · Read-only	Get a single lead-generation form by ID.
`reddit_get_pixel_last_fired_at` Free · Read-only	Retrieve the last time a pixel fired a conversion event (ISO 8601).
`reddit_get_saved_audience` Free · Read-only	Get a single saved audience by ID.
`reddit_list_custom_audiences` Free · Read-only	List the custom audiences owned by an ad account (customer lists, engagement/visitor audiences, etc.).
`reddit_list_lead_gen_forms` Free · Read-only	List the lead-generation forms for an ad account.
`reddit_list_pixels_by_ad_account` Free · Read-only	List the conversion pixels attached to an ad account.
`reddit_list_pixels_by_business` Free · Read-only	List the conversion pixels owned by a business.
`reddit_list_saved_audiences` Free · Read-only	List the saved (reusable) targeting audiences for an ad account.
`reddit_post_conversion_events` Pro · Write	Send server-side conversion events to a pixel via the Conversions API (CAPI).
`reddit_update_custom_audience_users` Pro · Destructive	Add or remove users in a CUSTOMER_LIST custom audience (max 2,500 user_data rows per request).
`reddit_update_saved_audience` Pro · Write	Update a saved audience by ID (partial update).

Targeting & Planning

Tool	What it does
`reddit_generate_bid_suggestion` Free · Read-only	Generate a bid suggestion for a prospective ad group.
`reddit_get_app_last_fired_at` Free · Read-only	Retrieve an app's last app-event fire times (a connectivity/health report for app-event integration).
`reddit_get_channel_planning_reach` Free · Read-only	Get a reach prediction for a channel plan.
`reddit_get_skadnetwork_availability` Free · Read-only	Get SKAdNetwork (iOS attribution) conversion-value availability for an app.
`reddit_list_apps_by_ad_account` Free · Read-only	List the mobile apps registered to an ad account (for app-install/app-event campaigns).
`reddit_list_carriers` Free · Read-only	List the mobile-carrier targeting options.
`reddit_list_communities` Free · Read-only	List targetable communities (subreddits).
`reddit_list_community_suggestions` Free · Read-only	Get suggested communities to target, seeded by topic names (comma-separated) and/or a website URL.
`reddit_list_devices` Free · Read-only	List the device targeting options.
`reddit_list_geolocations` Free · Read-only	List geolocation targeting options.
`reddit_list_interests` Free · Read-only	List the interest targeting options.
`reddit_list_keyword_suggestions` Free · Read-only	Get keyword targeting suggestions (a POST-as-read query — it changes nothing).
`reddit_list_languages` Free · Read-only	List the language targeting options.
`reddit_list_third_party_audiences` Free · Read-only	List the third-party audience targeting options available to your account.
`reddit_list_time_zones` Free · Read-only	List the supported ad-account time zones.
`reddit_search_communities` Free · Read-only	Search targetable communities (subreddits) by name and topic.
`reddit_validate_geolocations` Free · Read-only	Validate a set of geolocation targets (a POST-as-read validation — it changes nothing).
`reddit_validate_keywords` Free · Read-only	Validate a set of targeting keywords (a POST-as-read validation — it changes nothing).

Still need help? Ask the team