facebook/php-business-sdk

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

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

Added

• Add partner_client_id field to AttributionData

Full Changelog: 25.0.0...25.0.1

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

Added

• Add additional AMM fields: attribution_method, decline_reason, auditing_token, linkage_key
• Add attribution_setting nested field with inactivity_window_hours, reattribution_window_hours

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

Added

• Add AMM fields to attribution data

Full Changelog: 23.0.2...23.0.3

Full Changelog: 23.0.1...23.0.2

Full Changelog: 23.0.0...23.0.1

Changed

• Fix the OriginalEventData class to add the missing methods

Changed

• Update attribution_data, custom_data and original_event_data fields

Added

• advanced_measurement_table field to Event for Conversions API.

Changed

• Graph API call upgrade to v11.0

Added

• Support for sending multiple values for certain UserData parameters to Conversions API.

Changed

• Graph API call upgrade to v10.0

Added

• action_source field to Event for Conversions API.

Fixed

• opt_out field was being removed when set to false for Conversions API.

Changed

• Graph API call upgrade to v9.0

Added

• delivery_category field to Content for Conversions API.

Changed

• Add empty to the list of reserved keywords.
• Change empty value enum name in AdsPixelFirstPartyCookieStatusValues and AdsPixelDataUseSettingValues

Changed

• Fixed a normalization issue for zero values in CustomData in Conversions API
• Start passing in the appsecret_proof to Conversions API custom http_clients when an appsecret is set
• A Conversions API EventRequest custom http_client must now be an object instead of a class name

Added

• Added batching support to Conversions API. Create batched event requests by using BatchProcessor.

Added

• lead_id field to the Conversions API user_data section.
• Added HttpServiceInterface to enable the default request object to be overridden by a user-defined HTTP Request Service class. Can be used to create Conversions API event requests.

Added

• Added async support to Conversions API - Create event request promises by using EventRequestAsync.

Changed

• Graph API call upgrade to v8.0

Added

• delivery_category field in custom_data section for Conversions API(formerly Serverside API).