NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #942 most downloaded on Packagist
PHP SDK for Facebook Business
Latest stable
26.0.3
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 9 days to 4 months
Most releases are documented
notes for 40 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
153 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Changelog: https://developers.facebook.com/ads/blog/post/2017/07/18/marketing-api-2.10/
Changelog: https://developers.facebook.com/ads/blog/post/2017/07/18/marketing-api-2.10/
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Use /nativeoffers as an endpoint. The endpoint /offers is associated with the old product and has been deprecated.
/ACCOUNT_ID/adsets and /AD_SET_ID. See Targeting Specs. If you use this placement you must also select feed as a position and for device_platforms select mobile since Instant Articles is for mobile only./nativeoffers as an endpoint. The endpoint /offers is associated with the old product and has been deprecated.offer_id in the promoted_object for an ad set.** Please Review These Changes
place_page_set_id field under Ad creative is now optional for versions v2.7 and v2.6
and has been deprecated in v2.8. See Ad Creative.offer_data under link_data for an ad object has been deprecated.AdAccountGroup have been deprecated. To manage Ad Accounts, you should use Business Manager or Business Manager API with business_management extended permission.AD_ACCOUNT/audiences has been deprecated.ad_object_by_url field for /search in Ad Targeting Search has been deprecated.actor_id, actor_image_hash, actor_image_url, and actor_name have been deprecated from ad creative GET./insights endpoint.
In earlier releases it supported the params: fields,summary, default_summary, filtering and sort. However/insights should always exactly return what you queried in the POST requests./insights if you provided an invalid field as a parameter. We now send an the error message which points to a list of valid fields./insights fields in a variety of types: some fields were string such as impressions, some were numericstring, and some were float. We now return all numeric fields, including float as numericstring. All floating point numbers will maintain six precision points.post_like in the actions field is now named post_reaction, see Ads Action Stats. This is more consistent with naming in user interfaces.The owner_business field has been deprecated and no longer exists for objects connected to a business, including Ad accounts, Ad Campaign, Product Catalog, and Instagram User.
This is a new major release, which diverges in behavior from the previous one. Please review these changes:
This is a new major release, which diverges in behavior from the previous one. Please review these changes:
Cursor. In the past there were exceptions to this rule, e.g.: AdAccount::getReachEstimate used to return a ReachEstimate.placement, so that advertisers can more easily identify and select placement options that will serve them best. Instead of having platform as the only dimension, advertisers can select placements across different dimensions, such as device type including desktop or mobile, publisher such as facebook, instagram, or audience_network, and placements of each publisher. Only Facebook has multiple placements currently. The field page_types will still be included in read results, but cannot be used to create or update placements in v2.7. More details in Targeting Spec./insights endpoints, we’ll introduce two new breakdowns options: publisher_platform and platform_position. Along with the existing impression_device breakdown, you can get performance metrics with these placement dimensions. See Insights Breakdowns for more details.object_story_id will be null for an ad creative created with an object_story_spec. The effective_object_story_id will always be the object_story_id regardless of object_story_spec. More details in Ad Creative.Deprecated the connectionobjects API
This is a new major release, which diverges in behavior from the previous one. Please review these changes:
connectionobjects APImax_product_count for DPA creatives. In order to opt-out of Carousel format, specify force_single_link=true.product_ad_behavior field at the Ad Set level/insights objects the fields parameter no longer accepts breakdowns. Now you should specified this in 'breakdowns' parameter in query. This includes: age, country, gender, frequency_value,hourly_stats_aggregated_by_advertiser_time_zone, hourly_stats_aggregated_by_audience_time_zone, impression_device, place_page_id, placement, product_id, and regionAuthorizationException, it should only throw now for errors that have to do with Authorization. Some errors that previously were AuthorizationException may become RequestExceptionRequestException now has a single ResponseInterface param in constructorNothing published for this version
Add support for dynamically create local ads
Comply with Facebook Graph API v2.5.
Nothing published for this version
Nothing published for this version
Comply with API v2.4 changes: https://developers.facebook.com/docs/marketing-api/changelog#v2_4
Cursor now supports offset based pagination
Provide support for AdsAPI v2.3. Changelog
Provide support for AdsAPI v2.3. Changelog
Add Dynamic Product Ads Support
Added thumbnail_url, thumbnail_width, thumbnail_height to AdCreative
Fixes an issue that prevented cursors from implicitly fetching next pages of data
Fixes an issue that prevent file uploads in PHP 5.4
Remove facebook/php-sdk-v4 and psr/log dependencies
Add support for Local Awareness
AdImage now support bulk upload through zip files
Bumping tag to fix issues with Reach and Frequency code in 0.9.8
Bumping tag to fix issues with Reach and Frequency code in 0.9.8
Adds support for Reach and Frequency predictions and reservation
Implement default normalization for emails in:
Add archive functionality to AdCampaign, AdSet, AdGroup.
Connection to AdAccountGroups when retrieving AdAccounts
See README.md for how to instantiate a FacebookSession correctly as you now need to set a default application.
See README.md for how to instantiate a FacebookSession correctly as you now need to set a default application.
See examples/custom_auciences.php which has a full working example. You now need to pass a CustomAudienceType type the addUsers function and the hashing is handled automatically.
Fixed incorrect namespace from #7
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.