The Business SDK is a toolkit that simplifies how you interact with a suite of Facebook's business-focused APIs. It is an upgraded version of the Marketing API SDK that includes Marketing API as well as many Facebook APIs from different platforms such as Pages, Business Manager, Instagram, etc.
The Marketing API SDK is specifically for ads, which helps you to integrate with Marketing API and manage your Facebook ads much easier.
You can download the SDK from Github, or one of the package management systems your language uses. We provide a composer for PHP, Mavin for Java, pypi for Python, gem for Ruby, and npm for Nodejs, as following:
If the endpoint is supported in latest API version but not supported in SDK, you could report it on Github. We will have bump up versions, such as v3.0.1, to enable some high demand requests.
Yes, you need to connect your Page to your App so your App has the ability to access certain Pages API endpoints.
You can add
CurlLogger at the beginning of your class to allow the terminal to print the
curl request when you run an SDK function call. If the
curl request is incorrect, for example, you see a totally different
curl request for the exact same parameters on the same endpoint from Graph API Explorer tool, then please help file a bug in Github. Different languages might have different syntax to add the logger so please refer to the Github Readme file or sample code to see how to implement the logger.
You cannot. The Business SDK started with v3.0.
The Business SDK includes some endpoints that are still in beta, such as the Instagram Content Publishing APIs and Solution to Onboarding Clients at Scale APIs. You need to get your app approved for those beta version endpoints before you can use the related SDK functions successfully. Learn more about available endpoints in the Graph API Reference docs.
To begin troubleshooting, please enable debugging in the
There are many possible causes for a failed request:
If it's caused by incorrect parameters, you'll see error descriptions in the exception message. Check Graph API Docs to get more information about error codes and error handling.
If it's caused by permission issue, you'll see error messages like "permission denied" or "unknown path". Check your access token or app secret to make sure the needed permissions are included.
If in stacktrace you see that the failed request is caused by exceptions such as
MalformedResponseException, it is likely an SDK bug (or your own bug, depending on the stacktrace). If you see in the debug message that the params sent to the server don't match what you specified, it is possible that you didn't specify the param correctly, or the SDK didn't assemble the request properly. If it is an SDK bug, please help report it on Facebook Platform Bugs. Thanks!
Check your network and retry.
For a temporary server issue, typically retry should work after a few seconds. You could retry, or report the issue at Facebook Platform Bugs if it happens too often.
If the server persistently responds with "Unknown error," then it is potentially a server bug. Please help report it on Facebook Platform Bugs. Thanks!