facebook-business

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

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

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.1...23.0.2

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/23.0.0...23.0.1

In this release, we introduced version one of ThirdPartyAccount library in Python and Node.js SDKs to simplify the usage of the 2Tier APIs. Additionally, updated parameter list for the original_event_data parameter. We are planning to extend these features to other languages soon. Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/22.0.5...23.0.0

This release contains V1 of ThirdPartyAccount Library - SDK library to simplify the usage of the 2 Tier APIs

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/22.0.4...22.0.5

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/22.0.3...22.0.4

Hey Everyone, We are releasing latest minor version of Meta Business SDK v22.0.3. Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/22.0.2...22.0.3

Hey Everyone, We are thrilled to announce the release of Meta Business SDK v22.0, which now supports Graph API v22.0 and Marketing API v22.0. This release will include bug fixes, dependency upgrades, new features, and most importantly, an updated API interface to match Graph API v22. Here are few highlighted changes Added support on POST /{ad-account-id}/video_ads, deprecation of few instagram endpoints Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/21.0.5...22.0.2

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/21.0.0...21.0.5

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/20.0.3...21.0.0

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/19.0.3...20.0.0

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/19.0.1...19.0.2

Hello again! Apologies for the delay in rolling out this minor version update. Your patience is to be rewarded! We're offering much more than you might expect from a typical minor version bump.

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/19.0.0...19.0.1

Happy New Year! As of January 23, 2024, we are thrilled to announce the release of Meta Business SDK v19.0, which now supports [Graph API v19.0 and Marketing API v19.0]. Due to the code freeze in December, we bypassed the minor version increments for v18.0. However, during this period, our developers remained actively engaged in our community, submitting issues and pull requests. While we updated the [Changelog] to include all API interface changes, you can access comprehensive code modifications in our repositories.

Full Changelog: https://github.com/facebook/facebook-python-business-sdk/compare/18.0.5...19.0.0

18.0.4..18.0.5

18.0.3..18.0.4

18.0.2..18.0.3

18.0.1..18.0.2

🐛 Bug Fix 🔨 Address Python Single Quote Escape Issue https://github.com/facebook/facebook-python-business-sdk/commit/22d7355fbe25b390ca4936684140b124ddb024a9

18.0.0..18.0.1

Introducing Meta Business SDK v18.0 for Python

Time flies. Today, (September 15, 2023) we’re announcing the release of Meta Business SDK v18.0 to support the [Graph API v18.0 and Marketing API v18.0]. It represents a major update which addresses numerous longstanding issues and expands support to additional features, nodes, and types. While you can find a comprehensive list of changes in our [Chagnelog], here are also following notable SDK-only updates that we believe are relevant to our developer community.

• AdAssetFeedSpecAssetCustomizationRule and AdAssetMessageExtensions Support: Developer is able to Get a list of structuralized AdAssetFeedSpecAssetCustomizationRule and AdAssetMessageExtensions objects from AdAssetFeedSpec node.

• AdsHistogramStats Support: Developer is able to Get a list of structuralized AdsHistogramStats objects from multiple video play related metrics.

• BusinessImage, BusinessVideo, BusinessCreativeFolder Support: Developer is able to Post and Get these types of objects via Business node.

• Four Instagram Nodes Support: InstagramCarousel, InstagramComment, InstagramMedia, and InstagramUser are now available for developers to work on, including all POST and GET APIs.

• Multiple LeadGen Form Objects Support: Developer is able to work on multiple LeadGen Form related objects, including LeadGenContextCard, LeadGenCustomDisclaimer, LeadGenThankYouPage.

A full API spec change could be viewed here.

Added

• advanced_measurement_table field to Event for Conversion API

Changed

• Graph API call upgrade to [v11.0]https://developers.facebook.com/docs/graph-api/changelog/version11.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

• Enum compatibility for Python 2.7

Changed

• Graph API call upgrade to v9.0

Added

• delivery_category field to Content for Conversions API.

Added

• Added HttpServiceInterface to enable the default request object to be overridden by a user-defined HTTP Request Service object. Available for Conversions API create event requests.
• Added batching to Conversions API. Create batched event requests by using BatchProcessor.