Skip to main content
Creating system users and generating tokens requires admin access to the business portfolio that owns the Meta app.

​
Create a system user

A system user belongs to your business portfolio rather than to a person, so the token it issues keeps working when staff leave.

1

Sign in to Meta Business Suite

Sign in to your Meta Business Suite account and open the business portfolio that owns the Meta app.

  • Under Users in the left menu, select System users.
Business settings System users page with the Add button highlighted
2

Add the system user

Click Add, then complete the Create system user dialog.

  • System user name — a name that identifies the integration, for example StackOne Integration.
  • System user role — the access this system user has in the business portfolio. The dialog opens on Employee.
  • The dialog states that your business portfolio will be the owner of this system user.
  • Click Create system user.
Create system user dialog with the name field, role selector, and Create system user button highlighted

​
Give the system user access to the app

The token is issued for a specific Meta app, and Meta will not offer any permissions until the system user holds a role on that app.

1

Assign an app role

Select the system user in the list, then use the Assigned assets tab to give it a role on the Meta app the integration uses.

  • Without an app role, the Assign permissions step reports No permissions available and the token cannot be generated.
  • Assign the ad accounts and Pages the integration needs at the same time. A token only reaches assets the system user has been given.

​
Generate the access token

The token is generated from the system user and pasted straight into StackOne Hub.

1

Start the token wizard

With the system user selected, click Generate token.

System user detail with the Generate token button highlighted
2

Select the app

On the Select app step, answer What app would you like to generate a token for? by choosing your Meta app, then click Next.

Generate token wizard on the Select app step with the app selector and Next highlighted
3

Choose when the token expires

On the Set expiry step, answer When should the token expire?.

  • 60 days (recommended) — the token stops working after 60 days and has to be regenerated and re-entered in StackOne Hub.
  • Never — the token keeps working until it is revoked, which suits an unattended integration.
  • Click Next.
Generate token wizard on the Set expiry step with the 60 days and Never options highlighted
4

Assign the permissions and generate

Enables actions: Create Ad, Create Ad Creative, Create Ad Set, Create Business System User, Create Campaign, Create Custom Audience, Create Lead Gen Form, Create Pixel, Delete Ad, Delete Ad Creative, Delete Ad Set, Delete Campaign, Delete Custom Audience, Get Ad, Get Ad Account, Get Ad Account Insights, Get Ad Creative, Get Ad Insights, Get Ad Set, Get Ad Set Insights, Get Business, Get Campaign, Get Campaign Insights, Get Custom Audience, Get Lead, Get Lead Gen Form, Get Me, Get Pixel, Get User, List Ad Accounts, List Ad Creatives, List Ad Sets By Account, List Ad Sets By Campaign, List Ads By Account, List Ads By Ad Set, List Business Client Ad Accounts, List Business Owned Ad Accounts, List Business System Users, List Campaigns, List Custom Audiences, List Lead Gen Forms, List Leads By Ad, List Leads By Form, List My Accounts, List Pixels, List System User Assigned Users, List User Accounts, List User Businesses, Update Ad, Update Ad Account, Update Ad Set, Update Campaign, Update Custom Audience

On the Assign permissions step, answer What permissions will be granted to the app? by selecting the permissions this integration needs, then click Generate token.

5

Copy the token

Copy the generated token and paste it into the System User Access Token field in StackOne Hub.

  • System User Access Token — the token generated for the system user. It begins with EAA.
  • Meta shows the token once, so store it securely before closing the dialog.
  • Revoke tokens on the system user invalidates every token issued to it, including the one in StackOne Hub.
Generate token wizard on the Assign permissions step showing the No permissions available message for a system user with no app role

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • System User Access Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account on your Accounts page.