Updated 4 Sep 2026: Reddit's live Ads API docs changed again. Current global notices, Get A Report and the campaign migration guide now use October 30 for the >7-day HOUR reporting restriction and September 30 for objective rollout/lead-form migration, while the What's New table still contains September 21 entries. Updates the dossier to reflect the current conflict rather than treating the earlier December 8 date as settled.
Key details
- The current Reddit Ads API site-wide notice says new campaign objective enums roll out September 30, 2026.
- The dedicated Campaign Objective Migration guide also says September 30.
- The current What's New table still lists September 21 for new objective enums and the Lead Generation Forms API sunset.
- Existing ads using onsite forms are still listed to pause September 30.
- Legacy objective enums remain supported for compatibility.
- `use_catalog` is part of the SALES objective migration.
- The current What's New notice/table and Get A Report page say HOUR reports longer than seven days begin failing October 30, 2026.
- The previously published December 8 reporting date is no longer present on the current primary pages checked September 4.
What builders should take away
- Implement the objective-enum mapping now and set September 21 as the conservative internal readiness date until Reddit reconciles its conflicting September documentation.
- Move onsite lead-generation workflows to external forms and verify Pixel or Conversions API event delivery before the earlier possible cutoff.
- Export any onsite lead-form records you need before September 21 rather than relying on the migration guide’s later September 30 date.
- Split hourly-report requests into seven-day-or-smaller windows before October 30.
- Monitor Reddit’s live What's New and migration pages during September; do not hard-code operational planning to a date copied from one documentation page.
What changed
Reddit’s live Ads API v3 documentation has changed the published dates since BTN’s September 3 update. The global notices on the Ads API pages and the dedicated Campaign Objective Migration guide now say updated objective values roll out September 30, 2026, and that onsite lead-generation forms should be retrieved before a September 30 API sunset. However, the What's New table on the same documentation site still lists September 21 for the new objective enums and Lead Generation Forms API sunset, with existing onsite-form ads pausing September 30. Separately, the current What's New notice, What's New table and Get A Report page now say the `HOUR` breakdown will reject ranges longer than seven days starting October 30, 2026. That reverses the December 8 date that the live documentation showed when BTN updated this dossier on September 3.
Why it matters
The technical migration remains consequential, but the immediate operational risk is now documentation drift inside Reddit’s own primary source. Ad-tech integrations still need new objective mappings, an external/offline lead-form path and chunked hourly reporting, but teams should not key deployment plans to a single Reddit date without rechecking the live docs. Because the What's New table retains September 21 while the migration guide says September 30, the prudent engineering deadline is the earlier date until Reddit reconciles the pages.
Reddit’s objective dates now disagree with each other
The site-wide notice and dedicated Campaign Objective Migration guide say the new objective values roll out September 30. The What's New table on the same API site still lists September 21 for Campaigns, Ad Groups and Ads. Legacy objective enums remain supported, but newly created campaigns can return the new values once rollout begins.
The lead-form cutoff has the same September conflict
The migration guide says onsite lead-generation forms are no longer supported and tells developers to retrieve historical form data before an API sunset on September 30. The What's New table still says the Lead Generation Forms API sunsets September 21, while existing onsite-form ads pause September 30. Advertisers are directed toward external forms measured with the Reddit Pixel or Conversions API.
Hourly reporting is back to October 30 in the live docs
Current global notices, the What's New table and Get A Report documentation say that from October 30, requests using the `HOUR` breakdown for more than seven days will return a 400 response. BTN’s September 3 version used December 8 because Reddit’s live documentation showed that date at the time; the current primary pages no longer do.
Treat this as one migration, but use conservative cutoffs
Campaign creation, lead capture and historical reporting are still changing in the same general window. Teams should implement the technical changes now, use September 21 as the safe internal readiness date for objectives/forms until Reddit resolves the conflict, and chunk hourly reports before October 30.
Timeline
2026-09-21
Earlier date still present in Reddit's What's New table
The table currently lists new objective enums and Lead Generation Forms API sunset for September 21.
2026-09-30
Date used by Reddit's migration guide and page notice
The dedicated objective migration guide says updated objective values roll out September 30 and says lead-form data should be retrieved before a September 30 API sunset; existing onsite-form ads are also scheduled to pause.
2026-10-30
Current hourly-report cutoff
Current Reddit primary pages say HOUR reports covering more than seven days will return 400 errors from October 30.
What to watch next
- Whether Reddit reconciles the September 21 versus September 30 objective and lead-form dates across its own documentation.
- Whether the October 30 hourly-report deadline changes again before enforcement.
- Any additional migration guidance for advertisers moving from onsite lead forms to external forms.
- Whether legacy objective enums receive a defined end-of-support date.
Still unclear
- Reddit’s primary documentation is internally inconsistent on the objective and lead-form cutoff: the What's New table says September 21 while the global notice and campaign migration guide say September 30.
- The reporting deadline has changed in Reddit’s live documentation more than once; October 30 is the current date on the primary pages checked September 4, not a guarantee that Reddit will not revise it again.
Sources
Direct reading behind this dossier.
4 sources
What's New
Reddit Ads API
primary changelog
Current page shows an October 30 HOUR-report cutoff in the notice/table, a September 30 objective notice, but September 21 objective and lead-form entries in the detailed table.
Campaign Objective Migration
Reddit Ads API
primary migration guide
Current guide says objective values roll out September 30 and tells developers to retrieve onsite lead-form data before a September 30 API sunset.
Get A Report
Reddit Ads API
primary documentation
Current page notice states HOUR reports are limited to seven days or less starting October 30, 2026.
Conversions API
Reddit Ads API
primary documentation
Current measurement path for conversions as onsite lead forms are retired.
Discussion
Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.
0 visible comments
Join the discussion
Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.
Sign in to comment