Reddit Ads

Reddit Ads (Ads API v3)

This connector reads Reddit Ads accounts through the Ads API at https://ads-api.reddit.com/api/v3: businesses, ad accounts, campaigns, ad groups, ads, funding instruments and performance reports. It does not create or change campaigns.

Setup. A business admin with a verified account creates a developer application in Reddit Ads: Business, Developer Portal, Add Apps, Create an app. Set its Redirect URL to the redirect URI shown on the connector page. Copy the app ID and secret into this connector, save, then click Authorize with Provider and sign in with the Reddit account that has access to the ad accounts (check the username on Reddit's consent page; log out first if it shows another account). The connector asks for the adsread scope with duration=permanent, so it receives a refresh token and renews the one-hour access token by itself. This is not the same as the general Reddit API app at reddit.com/prefs/apps used by the reddit connector.

Which tool first. reddit_ads_get_me confirms the authorization. Then reddit_ads_list_my_businesses gives the business id, reddit_ads_list_business_ad_accounts the ad account ids, and from there campaigns, ad groups, ads and reports.

Ids. Business ids are UUIDs; ad account, campaign, ad group and ad ids are strings as returned by the API. Pass them unchanged. A report row carries only ids: call reddit_ads_get_ad or reddit_ads_get_campaign to put names on them, or list the campaigns once and match.

Pagination. List answers carry pagination.next_url; when it is present, call the tool again with page_token set to the page.token value from that URL. page_size goes up to 1000.

Reports. reddit_ads_get_report answers at once (no polling). starts_at and ends_at must be on a full hour in UTC (2026-09-01T00:00:00Z); use time_zone_id for the account's local days. Up to 3 breakdowns (4 with COUNTRY and REGION); HOUR only for ranges up to 7 days, and from 8 December 2026 Reddit rejects combining more than one of KEYWORD, COMMUNITY, INTEREST and LANGUAGE. Money values are scaled: SPEND, CPC, CPV, ECPM and CONVERSION*_ECPA are in millionths of the account currency (divide by 1,000,000), CONVERSION*TOTAL_VALUE is in hundredths (divide by 100). Metrics can take up to 6 hours to settle; late conversions are added in the daily refresh.

Rate limits. Limits are per authorized user and endpoint group, e.g. 400 requests a minute for campaign reads. A 429 means wait and retry with backoff; the RateLimit response header shows what is left.

Errors. 401: authorize again. 403: the user lacks a role on that ad account or business. 404: wrong id, or the id belongs to an account the user cannot see.