What's New

Check out the tables below to see a list of the latest updates and modifications that have been made to the API. These tables provide a detailed overview of changes, including new features, improvements, and any fixed issues, ensuring you stay informed about the latest developments and enhancements in our API.

Upcoming Changes

Date	Endpoint or Schema	Description
September 30, 2026	Lead Generation Forms	Existing ads using onsite forms will be paused.
September 21, 2026	Campaigns Ad groups Ads	New objective enums will be rolled out. Support for legacy objective enums will continue to help minimize disruption to existing integrations. use_catalog will be added to Campaigns API. This should only be set to TRUE for SALES objectives. Defaults to FALSE. Breaking changes: Campaigns will return new objective enums for campaigns created with the new objectives. If your integration stores, displays, maps, or reports on objective values, review the mapping table and update your logic to avoid disruption.
September 21, 2026	Lead Generation Forms	Lead Generation Forms API will be sunsetted as onsite forms will no longer be supported. Breaking changes: Advertisers must transition to using offline forms using the Reddit Pixel or Conversions API. Advertisers may also use the GET and LIST endpoints to retain onsite forms for records prior to this deadline.
July 13, 2026	Campaigns Ad Groups	conversion_pixel_id will be required for all ad groups and campaign budget optimization (CBO) campaigns. Breaking changes: Advertisers must explicitly set conversion_pixel_id for all ad groups and CBO campaigns. Implementations without this field will fail and return an error. Find your Pixels with List Pixels by Ad Account.

Released Changes

Date	Endpoint or Schema	Description
June 18, 2026	Reports	Marked slot-based custom conversion event fields (CONVERSION_CUSTOM_EVENT_1_* through CONVERSION_CUSTOM_EVENT_20_*) as deprecated. Use conversion_custom_events to request custom conversion events by name going forward. Each request can select up to 20 custom conversion events.
June 18, 2026	Reports	Made the LANGUAGE breakdown available for Get A Report.
June 17, 2026	Lead Generation Forms	Clarified the following: All form fields are required for Create Lead Generation Form. privacy_link must begin with HTTPS. At least one question must be required.
June 17, 2026	Product Catalog Product Set	Added read-only invalid_products_count field to the summary in Product Catalog and Product Set responses, such as List Product Catalogs, indicating how many products have critical issues and are not submitted for review.
June 16, 2026	Reports	Added conversion_custom_events to Reports requests and responses for Get A Report so custom conversion events can be requested by name with selected metrics and action sources.
June 16, 2026	Ads	Added configured_status and effective_status query parameters to List Ads for filtering ads.
June 16, 2026	Creative Assets	Made List Creative Assets and Get Creative Asset available.
June 16, 2026	Structured Posts	Exposed user-generated content enhancement settings on text, image, and video ad creatives in Get Structured Post responses and Create Structured Post Creation Job requests. Use enhancements.user_generated_content.enroll_status to state whether user-generated content may appear in your ad. Learn about Redditor Highlights.
June 15, 2026	Ad Groups Targeting	Made language targeting available for third-party API users. Advertisers can now see supported languages with List Languages, and set languages for ad group targeting.
June 10, 2026	Structured Posts	Added the read-only created_at field to the Structured Post schema returned by List Structured Posts, Get Structured Post, and Update Structured Post.
June 10, 2026	Custom Audiences	Added read-only business_id to custom audience responses via Get Custom Audience, List User Custom Audiences and Create Custom Audience.
June 1, 2026	Pixels	Added enhanced_signal_collection_config to the Pixel schema, returned by List Pixels By Ad Account and List Pixels By Business.
May 28, 2026	Ads	Added ad_group_id and campaign_id query parameters to List Ads for filtering by ad group and campaign.
May 27, 2026	Posts Structured Posts	Clarified that captions should be 180 characters or less.
May 26, 2026	Posts OAuth scopes	Removed legacy OAuth scopes history and read from the public scope Product Catalogs and Posts APIs. Third-party tokens now need only adsread for Get Post and List Posts, and only adsedit for Update Post, Create Post, Update Structured Post, and Create Structured Post Creation Job.
May 26, 2026	Apps	Made List Apps by Ad Account available for third-party API users.
May 25, 2026	Catalog Import	Added read-only invalid_products_count field to the summary in List Catalog Imports responses, indicating how many products were rejected as invalid and not imported.
May 25, 2026	Feature Access	Added conversion_pixel_id parameter to Get Feature Access endpoint to allow querying features based on a conversion pixel ID.
May 14, 2026	Ads	Documented that shopping_creative.destination_url may be an empty string, null, or a valid URI. Aligns the spec with existing behavior for shopping ads returned from List Ads and Get Ad.
May 14, 2026	Custom Audiences	Documented and enforced existing column_order validation for Update Custom Audience Users: requests must include one or two supported identifier columns.
May 12, 2026	Custom Audiences	Relaxed customer_list_config input validation for customer list audiences so clients can send a partial configuration instead of all fields.
May 7, 2026	Ads	Fixed Create Ad documentation so required ad_group_id appears in the Request Body section. Validation is unchanged.
May 7, 2026	Ads	Third-party Update Ad requests now accept click_url_query_parameters in the body, consistent with ad creation.
May 7, 2026	Businesses Ad accounts	Clarified the following: admin_approval and type fields for Ad Accounts API are only mutable by Reddit. country only accepts a 2-letter country code. Partner ad accounts won't appear in GET List Ad Accounts in Business.
May 7, 2026	Reports	Made the ASSET_ID breakdown available for third-party API users in Get A Report.
May 5, 2026	Campaigns Ad Groups Posts	Clarified the following: CBO-gated fields and bid nuances. Maximum creatives for carousel posts. Marked the Posts API as legacy endpoints. Advertisers can still call the legacy Posts endpoint, but are encouraged to use the Structured Posts API for managing posts.
April 28, 2026	Structured Posts	Made promoting eligible community posts available for third-party API users. Profile posts can't be promoted in the API. See how to promote one on Reddit.
April 27, 2026	Feature Access	Released Get Feature Access endpoint.
April 15, 2026	Ad Groups	Added PAGE_VISIT as a valid value for optimization_goal in ad groups.
April 14, 2026	Campaigns	Added read-only is_max field to all Campaign responses to indicate whether it is a Reddit Max campaign.
March 31, 2026	Campaigns Ad Groups	optimization_goal can't be set to NULL for video views campaigns. Breaking changes: Advertisers must use a valid goal for future video views campaigns.
March 27, 2026	Posts	Added supplementary_text field to text creatives. This is only available for select advertisers. Reach out for more details.
March 25, 2026	Reports	Clarified behavior of time_zone_id,starts_at, and ends_at parameters in Reports API.
March 16, 2026	Conversions API	Added item_price and quantity fields for the product in conversion events.
March 12, 2026	Ad Accounts	Added App Attribution fields.
March 11, 2026	Conversions API Reports	Added PHYSICAL_STORE, APP, and OTHER as valid values for action source. Added conversion_metrics to filter conversion data by action source.
March 9, 2026	Conversions API	Added event_source_url field for domain and click ID extraction.
March 2, 2026	Keyword Suggestions	Released List Keyword Suggestions.
February 9, 2026	Ad Accounts Campaigns Ad Groups Ads Custom Audiences Saved Audiences	Expanded and unified naming constraints across Ad Accounts, Campaign, Ad Groups, Ads, Custom Audience, and Saved Audience objects. These objects now share the same minimum and maximum length constraint of 500 for the name field. Previously these constraints ranged from a minimum of 0 to 3 and a maximum of 200 to 500, though they were not always advertised in our documentation.
January 22, 2026	Processing Status Support	Added support for PROCESSING as an Effective Status for Campaigns, Ad Groups, and Ads.
January 6, 2026	Structured Posts	Release Structured Posts schema.
December 29, 2025	Saved Audiences	Made Saved Audiences available for third-party API users.
December 9, 2025	Campaigns	Added invoice_label to the campaign's schema.
November 13, 2025	Campaigns Ad Groups Ads Custom Audiences Saved Audiences	Added delivery_status to the schemas.
October 2, 2025	Ad Groups	Added conversion_pixel_id to the ad group's schema.
October 1, 2025	Conversions API	Released Post Conversion Events. Advertisers are encouraged to migrate to take advantage of new features and long-term support.
August 13, 2025	Reports	Added 6 and 15 second video view rate metrics.
July 21, 2025	Rate Limiting	Released a new rate limiting system based on groups of endpoints. Also introduces RateLimit and RateLimit-Policy headers. For more information, see the Rate Limiting section of our docs.
June 26, 2025	Funding Instruments	Added search query parameter to Query funding instruments by business.
June 18, 2025	Ads	Made the click_url_query_parameters field on the ad object available for third-party API users.
June 12, 2025	Pixels	Released List Pixels By Ad Account and List Pixels By Business to support pixels retrieval under entities.
May 27, 2025	Product Catalogs	Added approved_products_count and rejected_products_count fields.
May 22, 2025	Communities Suggestions	Added new parameter to Communities Suggestions API.
May 5, 2025	Ad Groups Conversions API Pixels	Removed SEARCH, VIEW_CONTENT, and ADD_TO_WISHLIST support for optimization_goal in new ad groups Breaking changes: Advertisers must use PURCHASE, LEAD, SIGN_UP, or ADD_TO_CART for future conversion campaigns.
May 5, 2025	Campaigns Ad Groups Ads	App ID must now be set at the campaign level Structure limits have been updated for app install campaigns Breaking changes: Campaigns with ad group-level app IDs can't create new ads. Separate iOS and Android campaigns are now required.
March 13, 2025	Pixels	Released Get Last Fired At to retrieve the last time a conversion pixel was fired for conversion events
March 3, 2025	Account Exclusions	New exclusion fields for account
February 19, 2025	Lift Study Management/Brand Lift Studies	Support new custom question type for brand lift studies.
February 3, 2025	Product Catalogs	Released Product Catalog API.
January 10, 2025	List Lift Experiments	Added parameter to filter experiments by type.
December 9, 2024	SKAN Availability	Added support for campaign info with new SKAN hierarchy in SKAN availability API.
November 18, 2024	Bid Suggestions	Added new parameters to Bid Suggestions API.
November 14, 2024	Bid Suggestions	Added new Bid Suggestions API.
October 29, 2024	Apps	Released Get App Last Fired At.
October 2, 2024	Ad Accounts	Released Get Ad Account History
September 25, 2024	Geolocations	Released Do Geolocations Validations for city, country, DMA, postal code, and region
September 12, 2024	Geolocations	Added city field in geolocations endpoint and support city search results in List Geolocations
August 26, 2024	Reports	Include attribution_settings in Report View schema
August 26, 2024	Custom Audiences	Released Custom Audiences API with create, get, list, delete, and update audience users endpoints
August 9, 2024	Product Feeds	Added SKIPPED catalog import status
August 7, 2024	Lift Study Management/Brand Lift Studies	Added API endpoints to list studies and get a study by ID
July 30, 2024	Campaign/Funding Instruments	Funding Instrument ID will be a required field on all campaigns. Breaking change: All partners who wish to continue to create campaigns via the Reddit Ads API must update integrations by this date
July 30, 2024	Reports	Added attribution windows and sub_columns
July 25, 2024	Lead Generation Forms	Added lead generation forms endpoints for get, list, and create.
July 3, 2024	Gender	Update Targeting schema to expose gender targeting field to endpoints like Create Ad Group.
June 27, 2024	Ads	The preview_expiry field is now available for generating preview links for ads.
June 27, 2024	Ad Accounts	Released Update Ad Account. This endpoint may be used to update the attribution settings for an ad account.
June 6, 2024	Product Feeds	Made is_paused, interval, interval_count, and next_import_at fields non-nullable in the Feed Schedule schema.
June 6, 2024	Catalog Import	Made summary non-nullable.
June 6, 2024	Product Set	Made summary non-nullable.
June 6, 2024	Product Catalogs	Renamed approved_products_count to products_count, and made summary non-nullable.
June 6, 2024	Timezones	Included more time zones.
June 6, 2024	Reports	Added HOUR option for breakdowns.
June 6, 2024	Funding Instruments	Added a new API endpoint to List Funding Instruments by Ad Account.
June 6, 2024	Posts	Added new endpoint for updating a post. Currently, the only field that can be updated is allow_comments.
June 5, 2024	Product Feeds	Added new import error codes: INVALID_SALE_PRICE_EFFECTIVE_DATE, INVALID_EXPIRATION_DATE, and INVALID_ADULT.
May 30, 2024	Campaigns Funding Instruments	Added Funding Instrument ID as a new field on campaigns. Breaking change: Currently, Campaigns do not have an explicit field for Funding. After July 30, Funding Instrument ID must be populated on all campaigns.
May 29, 2024	Campaign Lifetime Budgets	All values on goal_value will be set to null, and the new spend_cap must be used until CBO is released later in Q3. We recommend all partners make this change, in order to take full advantage of future platform bidding functionality.
May 28, 2024	Ad Groups	Added two new targeting endpoints: list_devices and list_carriers.
May 21, 2024	Ad Groups	Updated ad group documentation and deprecated excluded_interests targeting property.
May 21, 2024	Lift Study Management/Brand Lift Studies	Added Create Brand Lift Study endpoint.
April 30, 2024	Post	Limited page size of List Posts to 25.
April 23, 2024	Ads	Added new effective_status option MISSING_PERMISSIONS to the Ad schema.
April 23, 2024	Members	Added affiliation enum field to Member, which represents the affiliation type of the member.
April 22, 2024	Campaign Lifetime Budgets	Exposed new spend_cap field on the campaign entity. Breaking change: Currently, campaign lifetime budgets are set by populating the goal_value field for the campaign. After April 22, spend_cap must be used.
March 11, 2024	Product Feeds	Added next_import_at field to feed schedule, which displays the time when the feed will be imported next time.
February 21, 2024	Ad Groups	Added excluded_keywords to the ad group's targeting schema.
February 6, 2024	Reports	Changed to a POST operation. Introduced filtering and metrics specifications. Added pagination.
February 6, 2024	Interest	Changed default behavior to return V3 interests and updated Interest schema.
February 6, 2024	General Changes	Updated path from /api/v2.0/ to /api/v3/. Introduced multi-level rate limits. Increased user-level rate limits to 5 requests/second. Removed account-level allow-listing requirement.
January 11, 2024	Campaigns	Added lifetime budgets fields goal_type and goal_value to the campaign schema.