Business Manager

Help businesses and agencies manage Facebook Pages, ad accounts and apps in one place. Business Manager API's help manage multiple ad account assets and permissions. You can also automate the creation of ad accounts. See Ads Help Center, Business Manager Basics.

In Business Manager you connect ads-related assets and other business assets for:

  • Permission management
  • Run campaigns on behalf of another company.
  • Create ad accounts and assign credit to buy ads.

Documentation Contents

Get Started

Start using our API. Work With Business Manager, Update Business Manager, Manage People and Roles, and Get Connection Objects. Learn about Invoices to view and manage credit sources associated with a business.

System Users

Create, retrieve, and update System Users. Learn how to Install Apps and Generate Tokens, Set System User Permissions, and Make API Calls.

Business Asset Management

Add, remove, or query a business' assets. Manage assets and who has access to them. Explore Business-to-Business functions.

Business Creative Assets

Create folders to store and share ad creatives between your business and another.

Business Onboarding

Create business manager, ad account and other assets via the API on behalf of your clients.

Best Practices and FAQ

Follow these guidelines if you are a Facebook Marketing Partner or a advertiser managing ad accounts or Pages.

JavaScript Ads Dialog for Payments

Provide a Facebook Ad Payments dialog in your own user interfaces with Facebook's JavaScript SDK.


JavaScript Ads Dialog for Payments

This is a secure solution that enables you to provide a Facebook Ad Payments dialog in your own user interfaces with Facebook's JavaScript SDK. Advertisers can trigger the dialog on your platform using our JavaScript SDK. Someone can then enter their ad account billing information in your solution. With this extension to our JavaScript SDK, you can onboard new advertisers more easily.

Step 1: Include the Facebook JavaScript SDK, along with your app ID.

<script>
  window.fbAsyncInit = function() {
    FB.init({
      appId            : ‘<YOUR-APP-ID>’,
      autoLogAppEvents : true,
      xfbml            : true,
      version          : 'v3.1'
    });
  };

  (function(d, s, id){
     var js, fjs = d.getElementsByTagName(s)[0];
     if (d.getElementById(id)) {return;}
     js = d.createElement(s); js.id = id;
     js.src = "https://connect.facebook.net/en_US/sdk.js";
     fjs.parentNode.insertBefore(js, fjs);
   }(document, 'script', 'facebook-jssdk'));
</script>

Step 2: Add this code to trigger the new dialog for someone's ad account. We recommend you trigger this code with a button click.

<script>
FB.ui({
  account_id: ‘<ACCOUNT-ID>’,
  display: 'popup',
  method: 'ads_payment',
});
</script>

Step 3: Verify a configured payment source. Make one of the following API calls against the user's ad account:

GET /act_<ACCOUNT_ID>/?fields=funding_source
GET /act_<ACCOUNT_ID>/?fields=funding_source_details

funding_source or funding_source_details has information about the payment details provided by the user. If the fields are not in the response, the user added no payment method to the account.