Overview

To have system users, your Business Manager must:

  • Have a real person as an admin user.
  • Own a Facebook app. You should claim the app and associate it with a business via API or in Business Manager.
  • Have the Facebook app go through an app review (and Business or Individual verification, if applicable) for the permissions the system user wants access to.

Facebook limits the number of system users per business manager based on your app's access level.

This bash script sample shows API calls which create a system user token then use it token to make Marketing API calls.

Types of System Users

There are two types of system users: admin system user and system user.

  • admin system user can create system users, ad accounts, assign permissions, and more.
  • system user can only access the assets they have permission for.

You should create one system user for each type of access you need. Use the admin system user to programmatically maintain the right roles. This way, if a system user token is compromised, it has limited scope and cannot compromise more permissions.

Give system user access to assets and use system users for most API calls. You should limit using admin system user for administrative actions, such as assigning permission. Since it has the most permissions, carefully safeguard the admin system user token.

Here is how it works:

Business Assets Access

Requirements and actions required to get access to business assets:

Your Business

We represent your business as an instance of a Business Manager in Marketing API. Your Business Manager must claim, create or share a Facebook app built on Marketing API. This app must have Standard Access or must be on a whitelist which enables it to create a system user access token.

Assets

Assets that belong to your Business Manager. For example: pages, ad accounts, and so on.

Admin User

All instances of Business Manager have an admin user. Typically, this is the same person who originally created the Business Manager object and manages it over time.

Admin System User

An admin user can create this special type of user. An admin system user can create new users and access all assets belonging to the business. We do not recommend managing business' assets through an admin system user, since this user type has more power than a regular system user. Limit use of admin system user to creating other system user, and do not use it for access to assets.

System User

An admin user or admin system user can create a system user. This person can ultimately access assets. Use this type of user to manage a business' assets.

Permissions to Access

A system user must grant their user permission to access assets owned by a business.

System User Access Token

You need an app on the Marketing API with the standard access or your app must be whitelisted. Ensure that the app has gone through app review (and verification, if applicable) for required permissions. With a system user and this app, you can generate a system user access token. After you have this token, and after a system user grants user permissions to access assets, your can access those assets programmatically.

System Users And Custom Audiences

For a system user to operate with a Custom File Custom Audience in a business, a non system user needs to accept that Business’ Custom Audience terms of service. The acceptance must be made from an ad account that belongs to that Business.

Learn more about Custom Audience Terms Of Service and the options available for system users.

Limits

Your app on Marketing API has a certain access level. This determines how many system users you can create for the Business Manager that owns your app:

Level System Users Admin System Users

Development

1

1

Standard

10

1

You can group ad accounts by system user in responses based on a per-client or per- read/write basis. If you manage many ad accounts, loading all in the UI may be slow.