NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #981 most downloaded on Packagist
PHP SDK for Facebook Business
Last release 19 days ago
18 Sep 2026
Release timing varies
gaps range from 9 days to 4 months
Some releases are documented
notes for 23 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
152 releases · first in 2014
Full Changelog : 26.0.1...26.0.2
Full Changelog: 26.0.1...26.0.2
Full Changelog : 26.0.0...26.0.1
Full Changelog: 26.0.0...26.0.1
One column per quarter.
This release will include dependency upgrades, Conversions API Parameter Builder integration , new API features, and deprecation of the Commerce Order…
The Meta Business SDK v26 release will be published shortly after the release of Graph API v26. This release will include dependency upgrades, Conversions API Parameter Builder integration, new API features, and deprecation of the Commerce Order Management API and several legacy protocol features.
The Business SDK is now integrated with open sourced Conversions API Parameter Builder. You can leverage this new integration to improve the quality of your Conversions API integration. Key features: Auto-generates (gated by preference set by advertisers) and enhances parameters fbc, fbp, event_source_url, referrer_url, client_ip_address and automatic PII normalization/hashing for supported languages, see more here. The Commerce Order Management API (47 endpoints) is fully deprecated with no replacement. The Instagram Explore Feed ad placement is removed and returns errors if specified. Messenger Stories placement is silently removed from messenger_positions. Ads in WhatsApp Status gain new capabilities including identity spec, carousel up to 10 cards, and offsite-conversion optimization.
As part of our 2-year deprecation schedule for Platform SDKs, please note the upcoming deprecations and sunsets:
Sept, 2026: Facebook Platform SDK v20.0 will be deprecated
Jan, 2027:: Facebook Platform SDK v21.0 will be deprecated
Full Changelog : 25.0.2...25.0.3
Full Changelog: 25.0.2...25.0.3
In this release, we added Conversions API Parameter Builder integration . The server-side Event/ServerEvent can now auto-fill Conversions API paramete
In this release, we added Conversions API Parameter Builder integration. The server-side Event/ServerEvent can now auto-fill Conversions API parameters from the incoming HTTP request: call setRequestContext(request) (optionally with a Preference allowlist) and the SDK fills any empty fbc, fbp, event_source_url, and referrer_url fields at send time — plus client_ip_address and automatic PII normalization/hashing on PHP and NodeJS. Auto-fill is gated by Preference, never overwrites values you set, and is fully opt-in (no behavior change unless you call setRequestContext).
Full Changelog: 25.0.1...25.0.2
Full Changelog : 25.0.0...25.0.1
Full Changelog: 25.0.0...25.0.1
…and 3-second Viewers are planned for deprecation in June 2026 in favor of the new Media Views and Media Viewers metrics. Webhooks mTLS certificates wi…
In this release, Advantage+ Shopping Campaigns (ASC) and Advantage+ App Campaigns (AAC) can no longer be created or updated via the Marketing API starting v25.0, extending to all versions by May 19, 2026, as part of the Automation Unification toward the streamlined Advantage+ setup. The Ads Insights Async API now returns detailed error information on report failures, and several legacy metrics including Page Reach, Impressions, and 3-second Viewers are planned for deprecation in June 2026 in favor of the new Media Views and Media Viewers metrics. Webhooks mTLS certificates will transition to a new Meta-owned Certificate Authority starting March 31, 2026. For full details, see the official blog post
Full Changelog: 24.0.1...25.0.0
Full Changelog : 24.0.0...24.0.1
Full Changelog: 24.0.0...24.0.1
In this release, there are major changes like Dynamic Media will be enabled by default for Advantage+ Catalog ads via the Marketing API, requiring dev
In this release, there are major changes like Dynamic Media will be enabled by default for Advantage+ Catalog ads via the Marketing API, requiring developers to explicitly opt out if desired. The daily budget flexibility is increased from 25% to 75%, allowing higher spend on days with better opportunities while maintaining weekly spend limits. A new feature allows up to 20% of an ad set’s daily budget to be shared with other ad sets in the same campaign for improved performance without campaign budget optimization. The Facebook video feeds ad placement is no longer available in Marketing API v24.0, and attempts to use it will result in errors. Third-party access to create Click to Messenger Lead Gen (CTMLG) ads through the Marketing API is discontinued, though Ads Manager creation remains available.
Full Changelog: 23.0.3...24.0.0
Full Changelog : 23.0.2...23.0.3
Full Changelog: 23.0.2...23.0.3
Full Changelog : 23.0.1...23.0.2
Full Changelog: 23.0.1...23.0.2
Full Changelog : 23.0.0...23.0.1
Full Changelog: 23.0.0...23.0.1
Nothing published for this version
Fix the OriginalEventData class to add the missing methods
Update attribution_data, custom_data and original_event_data fields
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
advanced_measurement_table field to Event for Conversions API.
advanced_measurement_table field to Event for Conversions API.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Graph API call upgrade to v11.0
Support for sending multiple values for certain UserData parameters to Conversions API.
Graph API call upgrade to v10.0
Nothing published for this version
Nothing published for this version
action_source field to Event for Conversions API.
action_source field to Event for Conversions API.opt_out field was being removed when set to false for Conversions API.Nothing published for this version
delivery_category field to Content for Conversions API.
delivery_category field to Content for Conversions API.Nothing published for this version
Fixed a normalization issue for zero values in CustomData in Conversions API
Added batching support to Conversions API. Create batched event requests by using BatchProcessor.
lead_id field to the Conversions API user_data section.Added async support to Conversions API - Create event request promises by using EventRequestAsync.
delivery_category field in custom_data section for Conversions API(formerly Serverside API).
delivery_category field in custom_data section for Conversions API(formerly Serverside API).Your coding agent can read these notes before it upgrades. Set up the MCP server →