Meta / Facebook Developer Docs Mirror

Appearance

Mirrored from https://developers.facebook.com/documentation/games/sdk-reference/v7.1

June 30, 2026

Build

​

Instant Games SDK ​

Deprecated the bot subscription SDK APIs effective August 1, 2026. Developers no longer need to call these FBInstant.player APIs to subscribe players to game updates. Eligible players are handled automatically by the platform, so active guidance for the bot subscription SDK APIs has been removed from the Instant Games SDK reference.

June 7, 2026

Build

​

Expanded Canvas Game Migration guide ​

The Canvas Game Migration guide has been updated with additional guidance for migrating from Canvas Games to Instant Games with Network Enabled Zero Permissions (NEZP):

  • Submit your game for app review — Added a step covering how to submit your application for app review through Instant Games > Review > App Review for Instant Games before rolling out to players.
  • Application Migration — Added context on linking differing Canvas and Instant Game App IDs through Gaming Services > Migration so player identity can be mapped between them.
  • NEZP and CSP — Clarified how Network Enabled Zero Permissions and the Content Security Policy (CSP) allowlist govern external requests from your game.
  • Troubleshooting — Added an "Unable to connect or call external resources" entry explaining sandbox behavior and how to allowlist external resources.

April 28, 2026

Build

​

FBInstant.openExternalLinkAsync() is now available in Instant Games SDK v8.0. ​

FBInstant.openExternalLinkAsync(url) is now available in Instant Games SDK v8.0 for approved external URLs after platform confirmation.

Use this API when you need to send players to an approved external destination, such as a help center, support page, or publisher-managed website. The call resolves after the platform confirms and attempts to open the link, and rejects if the player cancels, the URL is invalid, or the client definitively fails to dispatch the request.

Before calling this API, check FBInstant.getSupportedAPIs() to confirm that openExternalLinkAsync is available on the current client.

April 28, 2026

Monetize

​

IAP Payment Webhooks ​

You can now subscribe to IAP Payment Webhooks to receive real-time server-to-server notifications when an in-app purchase succeeds or a refund is processed. Webhooks provide a reliable server-side signal that complements the client-side SDK flow, ensuring your game is notified of purchase events even if the player closes the game mid-purchase or experiences a network interruption.

Key capabilities:

  • Subscribe via the App Dashboard — Configure your webhook callback URL and verify token in the Use Cases > Webhooks section.
  • V2 payload format — Webhook notifications include the product ID, user ID, purchase platform, price, currency, purchase token, and payment environment.
  • Two event types — PURCHASE_SUCCESS for completed purchases and REFUND_SUCCESS for processed refunds.
  • Test from the App Dashboard — Verify your callback URL and send test webhook payloads directly from the UI before going live.

For setup instructions, payload reference, and handling guidance, see IAP Payment Webhooks.

April 14, 2026

Monetize

​

Rewarded Interstitial Ads API has been fully removed from the FBInstant SDK. ​

The Rewarded Interstitial Ads (RIA) API has been fully removed from the FBInstant SDK libraries. RIA was deprecated on November 15, 2025 and has been returning NO_FILL since that date. This removal is part of our effort to improve the overall quality of the ad experience by reducing game interruptions for players.

If you have not migrated away from Rewarded Interstitial Ads since November 2025, your code may break. Because the API has been removed from the SDK, any calls to the Rewarded Interstitial Ads API will fail.

We recommend adopting one of the following monetization alternatives:

  • Rewarded Video Ads — players opt in to watch a video ad in exchange for an in-game reward
  • In-App Purchases — offer virtual goods, currency, or premium content directly to players

April 8, 2026

Build

​

Instant Games Unity Plugin now available — build Instant Games in Unity with full C# SDK access, and Zero Permissions overlay views. ​

The Instant Games Unity Plugin is now available on GitHub⁠. The plugin provides a C# wrapper around the Facebook Instant Games SDK, enabling Unity WebGL games to access platform features without writing JavaScript.

Features ​

  • Full FBInstant SDK coverage — Player identity, social contexts, payments, tournaments, ads, matchmaking, and more, all accessible from C#
  • Async/Await API — All SDK calls use C# Task-based async patterns
  • Overlay views (NEZP) — Display player names, profile pictures, and social data securely through Meta-controlled iframes under the Zero Permissions model
  • Editor mocking — API calls return mock data in the Unity Editor so you can test without a browser
  • Editor tools — Built-in windows for bundle uploading, project optimization, and visual overlay view building

Requirements ​

  • Unity 2022 or later
  • Unity WebGL build target

April 4, 2026

Monetize

​

We are deprecating banner ads on the Instant Games platform. Starting April 2026, the number of banner ad impressions served across all games will gradually decrease, reaching full deprecation by March 31, 2027.

  • Updated Banner Ads documentation with deprecation notice and FAQ
  • Your game will continue to function normally — no code changes are required
  • Banner ad impressions will decrease gradually — there will not be a sudden cut-off

We recommend integrating alternative monetization formats in place of banner ads:

  • Rewarded Video Ads — players opt in to watch a video ad in exchange for an in-game reward
  • In-App Purchases — offer virtual goods, currency, or premium content directly to players

Both options are available today.

April 4, 2026

Build

​

Canvas deprecation reminder (September 30, 2026) with enhanced rollout controls, cross-play support, and upcoming IAP payment status webhooks. ​

As announced in July 2025, the Canvas platform will be deprecated on September 30, 2026. All Canvas and Instant Games must migrate to the Zero Permissions framework before this date.

We are continuing to invest in tools and capabilities to make migration easier:

  • Enhanced rollout controls — You can now migrate specific users to your Zero Permissions build, including the ability to target payer vs. non-payer users, before rolling out to your full player base. See the Canvas Game Migration guide for details.
  • Cross-play support — For eligible apps, we support cross-play between your Instant Game (NEZP) and off-platform apps, allowing players to maintain progress across platforms.
  • IAP payment status webhooks — Coming in the next few weeks, payment status webhooks will provide real-time notifications for In-App Purchase transaction events, improving reliability for your purchase flows.

February 25, 2026

Launch

​

Legacy bundle upload API endpoint is being deprecated on May 26, 2026. Migrate to the new two-step Bundle Upload Service. ​

The legacy bundle upload API endpoint (graph-video.facebook.com/{APP_ID}/assets) is deprecated and will be removed on May 26, 2026. Migrate to the new Bundle Upload Service, which uses a two-step upload flow:

  • Create an upload session via the Graph API (graph.facebook.com/v24.0/{APP_ID}/uploads)
  • Upload your bundle binary using the session ID

After uploading, use the new push-to-production endpoint to publish your bundle. The new service supports resumable uploads and explicit version control.

If you upload bundles manually through the Developer Portal, no action is needed — manual uploads already use the new service.

July 31, 2025

Build

​

Important changes to Web Games and Instant Games on Facebook, Network Enabled Zero Permissions (NEZP) is now General Availability. ​

Network Enabled Zero Permissions (NEZP) is now General Availability with Instant Games SDK API v8.0. This new connection model limits user data shared outside Meta while enabling richer social experiences.

Key Dates & Deadlines:

DateChange
August 1, 2025All newly created Instant Games must use Zero Permissions as the connection experience. Standard (blocking permissions) connection is no longer available for new apps.
September 30, 2026Sunset of Web Games on Facebook. Web Games will no longer be available unless migrated to Instant Games with Zero Permissions. Existing Instant Games (created on or before July 31, 2025) can continue using the standard connection experience until this date.

Required Migrations:

  • All existing Instant Games and Web Games must migrate to "Instant Games with Zero Permissions" before September 30, 2026.
  • Seamless App ID migration is supported (no new app required).
  • Granular rollout control tools are available for phased migration.
  • Limited cross-play support between Facebook Instant Games and Native Games.

Read the full announcement on Meta Developer Blog.

Unofficial mirror for reference/search purposes. All content originates from developers.facebook.com — see the source link at the top of each page. Machine-readable indexes: llms.txt · llms-full.txt · About

Content © Meta Platforms, Inc. · Built by Arjun Aditya