Open the Reddit OAuth consent page in the browser and wait for the callback. Returns the authorization URL if the login is not completed in time.

Show whether the server holds valid Reddit Ads credentials.

Revoke the stored refresh token and delete it from disk.

Call any Reddit Ads API v3 endpoint directly. Use for endpoints without a dedicated tool. Path is relative to https://ads-api.reddit.com/api/v3 (e.g. 'me' or 'ad_accounts/{id}/campaigns'). Bodies for POST/PATCH/PUT are usually wrapped as {"data": {...}}.

List every ad account the authenticated user can access, grouped by business. Start here to find ad_account_id values.

Get the authenticated Reddit Ads member or system user.

List businesses the authenticated user belongs to.

Get a business by ID.

Update a business.

List valid business industries.

List ad accounts owned by a business (not those shared into it).

Search the ad accounts a business can access, including shared ones, by name, ID, actor, role or asset.

Get an ad account: currency, time zone, attribution settings, approval status and account-level exclusions.

Update ad account settings.

Get the change log of an ad account (who changed what and when).

List Reddit profiles (t2_ user IDs) an ad account can post ads as. Profile IDs are needed for posts, creative assets and ads.

List Reddit profiles owned by a business.

Get a Reddit profile by ID.

List the funding instruments (payment methods, credit lines) of an ad account.

Query funding instruments available to a business.

List child funding instruments allocated from a funding instrument.

List supported time zones.

List approved click and impression tracker domains for ad event_trackers.

List mobile apps used in the ad account's past campaigns.

Get when each mobile conversion event last fired for an app.

Get SKAdNetwork campaign, ad group and ad quota for an iOS app.

List campaigns in an ad account.

Get a campaign including effective_status and delivery_status.

Create a campaign. All money values are micro-currency (1 USD = 1000000). Create it PAUSED unless the user asks otherwise.

Update a campaign. Pass only the fields to change. To delete set configured_status to DELETED, to archive set ARCHIVED. Deleting follows Reddit's rules: a campaign must be ARCHIVED first, and campaigns and ad groups can only be DELETED three hours after their last change (archive now, delete later). All money values are micro-currency (1 USD = 1000000).

List ad groups in an ad account.

Get an ad group including targeting, bidding and status.

Create an ad group inside a campaign. All money values are micro-currency (1 USD = 1000000). Create it PAUSED unless the user asks otherwise. Under campaign budget optimization the bid_strategy, bid_type, goal_type, optimization_goal and view_through_conversion_type must match the campaign and goal_value must be null.

Update an ad group. Pass only the fields to change. To delete set configured_status to DELETED. Deleting follows Reddit's rules: a campaign must be ARCHIVED first, and campaigns and ad groups can only be DELETED three hours after their last change (archive now, delete later). Targeting is replaced as a whole object. All money values are micro-currency (1 USD = 1000000).

List ads in an ad account. Filters are OR within a parameter and AND across parameters.

Get an ad including effective_status, rejection_reason, post_url and preview_url.

Create an ad in an ad group. Standard ads promote a post: first create one with reddit_ads_create_post_job (or reddit_ads_create_post) and pass its post_id (t3_...). Create it PAUSED unless the user asks otherwise.

Update an ad. Pass only the fields to change. To delete set configured_status to DELETED. The ad group cannot be changed.

Activate, pause, archive or delete several campaigns, ad groups or ads at once. Reddit has no hard delete for these entities; DELETED is the delete operation. Deleting follows Reddit's rules: a campaign must be ARCHIVED first, and campaigns and ad groups can only be DELETED three hours after their last change (archive now, delete later).

Create an ad post on a profile asynchronously. Poll reddit_ads_get_post_job until status is SUCCESS to get the post_id for reddit_ads_create_ad. Media is fetched by Reddit from public URLs.

Get the status of a structured post creation job (QUEUED|PROCESSING|SUCCESS|CLIENT_ERROR|SERVER_ERROR) and the resulting post_id.

List structured posts on a profile.

Get a structured post.

Update a structured post. Only allow_comments can be changed.

List posts on a profile (legacy posts API).

Create a post on a profile synchronously (legacy posts API). Prefer reddit_ads_create_post_job.

Get a post by ID (t3_...).

Update a post. Only allow_comments can be changed.

Add up to 50 assets to a profile's creative library (used by Reddit Max ads). Media is fetched by Reddit from public URLs. Poll reddit_ads_get_creative_asset_upload for the resulting asset.

Get the status of several creative asset uploads.

Get a creative asset upload: status (PROCESSING_MEDIA|ACTIVE|INVALID_MEDIA) and resulting asset.

List creative assets in a profile's library.

Get a creative asset.

Rename a creative asset.

Permanently delete a creative asset from the library.

Generate poster (thumbnail) images from a public video URL. Poll reddit_ads_get_poster_job for the result.

Get the status and generated posters of a poster generation job.

Get performance metrics for an ad account. Metric keys come back lowercase. spend, cpc, cpv, ecpm, conversion_*ecpa, app_installecpa, app_install_skan and app_install_*revenue are micro-currency (divide by 1000000); conversion*_total_value is in cents. Data can take up to 6 hours to settle.

Get minimum and suggested bid values (micro-currency) for a planned ad group.

Estimate audience size and delivery (impressions, clicks, conversions, reach) for a planned ad group. Limited to 10 requests per minute.

Get a Reddit-wide reach curve (impressions vs reach) for media planning.

Search subreddits for targeting by name or topic.

Look up subreddits by exact name, with subscriber counts and categories.

Suggest related subreddits from seed subreddits and/or a website URL.

List interest categories for targeting.

List geolocation targets. Without filters returns countries; filter by country for regions/metros, or search cities / postal codes.

Validate geolocation IDs or city names before using them in targeting.

List device makes and models for targeting.

List mobile carriers for targeting.

List languages for targeting.

List third-party data audiences (LiveRamp, Bombora) with sizes and costs.

Get keyword suggestions with monthly views from seed keywords.

Check whether keywords are brand safe.

List custom audiences (customer lists, retargeting, lookalikes) in an ad account.

Get a custom audience including its status and size.

Create a custom audience. For customer lists, add users afterwards with reddit_ads_update_custom_audience_users.

Add or remove users in a customer list audience. Values must be SHA-256 hashes of normalized (lowercased, trimmed) emails or mobile ad IDs. Max 2500 rows per call.

Permanently delete a custom audience.

List saved (reusable) targeting audiences.

Get a saved audience.

Save a targeting configuration to reuse on ad groups via saved_audience_id.

Update a saved audience. Set status to DELETED to delete it.

List lead generation forms in an ad account.

Get a lead generation form.

Create a lead generation form.

List Reddit pixels of an ad account.

List Reddit pixels of a business.

Get when each conversion event last fired for a pixel, to check tracking health.

Send server-side conversion events through the Conversions API (requires the adsconversions scope). Use test_id to send test events visible in Events Manager.

Request deletion of a person's data from an ad account (requires the adsdatadeletion scope).

Request deletion of a person's data collected by a pixel (requires the adsdatadeletion scope and business admin).

Get the status of a data deletion job (QUEUED|COMPLETED|FAILED).

List product catalogs of a business.

Get a product catalog.

Create a product catalog for dynamic product ads.

Update a product catalog.

Permanently delete a product catalog with its feeds, sets and products.

List feeds of a product catalog.

Get a product feed.

Create a scheduled product feed (max 2 per catalog, of different modes).

Update a product feed.

Permanently delete a product feed.

List feed import runs of a catalog.

List issues found while importing a feed.

Get a download URL for a feed import report.

List product sets of a catalog.

Get a product set.

Create a filtered product set for catalog ad groups (product_set_id).

Update a product set.

Permanently delete a product set.

List products in a catalog.

List products in a product set.

Create or update up to 1000 products in a catalog.

Delete up to 1000 products from a catalog by product ID.