---
title: "Marketing API v26.0 Release and Migration Summary"
type: summary
tags: [marketing-api, v26, migration, placements, creative, targeting]
created: 2026-08-25
updated: 2026-08-25
marketing_api_version: "v26.0"
confidence: high
sources: ["raw/official-2026-08-25-graph-api-v26-changelog.md", "raw/official-2026-08-25-v26-launch-post.md", "raw/official-2026-08-25-marketing-api-changelog-current.md", "raw/official-2026-08-25-marketing-api-changelog-markdown-access-tier.md", "raw/official-2026-08-25-graph-api-versions-current.md", "raw/official-2026-08-25-pypi-facebook-business-current.json.md", "raw/official-2026-08-25-npm-facebook-nodejs-business-sdk-current.json.md"]
---

# Marketing API v26.0 Release and Migration Summary

## Key Points

Marketing API v26.0 was released **July 29, 2026**. The full Graph v26.0 changelog is the canonical complete source because the dedicated Marketing API version URL is not a dependable standalone source. The release blog is highlights/context, not the completeness boundary.

1. **Delivery Estimate:** v26 removes `daily_outcomes_curve`, `budget_guardrail`, and `estimate_dau` from `GET /{ad-account-id}/delivery_estimate` and `GET /{adset-id}/delivery_estimate`. All remaining supported versions follow on **October 27, 2026**. There is no replacement API.
2. **WhatsApp Status:** third-party callers must explicitly include `wamo_whatsapp_identity_spec`; omitted `user_age_unknown` defaults to `true` when Status is selected; offsite Conversion Optimization is supported for Sales, Leads, and Engagement, Landing Page Views is supported, and carousels support up to 10 cards.
3. **Advantage+ Audience for HEC-F:** constrained non-broad/non-relaxed Housing, Employment, or Financial Products and Services ad-set creation must explicitly set `targeting_automation.advantage_audience` to `1` or `0`; omission returns `ADS_TARGETING__REQUIRE_EXPLICIT_ADVANTAGE_AUDIENCE_FLAG`. Broad/default and relaxed setups retain defaulting, and existing-ad-set updates are unaffected. The canonical changelog names the account ad-set creation endpoint; the blog additionally describes copied ad sets and lists update/copy endpoints, a source-level wording difference preserved in the durable pages.
4. **Instagram Explore Feed:** explicit Explore targeting is unavailable and errors; delivery shifts to other eligible placements.
5. **Website+App:** ads reject attached creatives with `applink_treatment=web_only`; all Marketing API versions follow on **October 27, 2026**.
6. **Messenger Stories:** `story` is silently removed from `messenger_positions` and absent from effective placements; historical targeting may retain it. Manual-placement clients remove it; Advantage+ Placements require no action. All versions, including unversioned calls, follow on **October 27, 2026**.
7. **Poll creatives:** `poll_spec` and `poll` under `interactive_components_spec` cannot be used to create or change a creative. Existing-ad updates that do not change creative continue. Affected: `POST /{ad-account-id}/adcreatives`, `POST /{ad-account-id}/ads`, `POST /{ad-id}`, `GET /{ad-account-id}/generatepreviews`. All versions follow on **October 27, 2026**.
8. **Creative Shops Ads:** eligible shop advertisers default to `destination_spec.destination_type = WEBSITE_AND_SHOP`; opt out with `WEBSITE_AND_SHOP_OPT_OUT`.

**Separate package lane:** the changelog said Meta Business SDK v26 would be published shortly after the API. As of retrieval, Python `facebook-business` is **26.0.0**, while npm `facebook-nodejs-business-sdk` remains **24.0.1**. This supports only package-specific claims, not “all SDKs shipped v26.”

**Current out-of-cycle Access Tier:** effective May 4, 2026, Ads Management Standard Access became **Marketing API Access Tier**; Standard/Advanced labels became **Limited access**/**Full access**; auto-approval fell from 1,500 to 500 calls in 15 days; errors use a rolling 500-request window with `< 15%`; screen recording was removed.

**Version lanes:** v24.0 remains listed until **October 6, 2026**. Do not apply the October 27 cross-version date to v26 changes unless the canonical source explicitly says so.

**Excluded as Graph-only:** Commerce Order Management, Rights Manager owner fields, legacy Graph protocol changes, and New Pages Experience Page fields/settings are not transferred into Ads behavior guidance.

## Relevant Concepts

- [[entities/marketing-api]] — current versions, access tier, and package/API distinction
- [[concepts/budgets-bidding]] — Delivery Estimate removal
- [[entities/placements-catalog]] and [[entities/instagram-ads]] — WhatsApp Status, Instagram Explore, Messenger Stories
- [[concepts/advantage-targeting]], [[concepts/audiences]], [[concepts/special-ad-categories]] — HEC-F explicit flag
- [[concepts/creative-formats]], [[concepts/campaign-structure]], [[concepts/advantage-plus-campaigns]] — destination, poll, and Shops changes
- [[concepts/conversions-api]] and [[syntheses/pixel-capi-setup]] — Parameter Builder lane

## Source Metadata

- **Canonical complete release source:** Meta, “Version 26.0,” released 2026-07-29; official Graph + Marketing changelog; retrieved 2026-08-25.
- **Launch context:** Meta, “Introducing Graph API v26.0 and Marketing API v26.0,” Ayyad Farah and Manjari Jain, 2026-07-29; retrieved 2026-08-25.
- **Current Marketing API changelog:** official current version table and Access Tier out-of-cycle section; retrieved 2026-08-25.
- **Current versions table:** official Graph/Marketing version schedule; retrieved 2026-08-25.
- **Package registries:** official PyPI and npm package metadata snapshots; retrieved 2026-08-25.