Skip to main content
Meta Integration Setup in Olympus Meta integration connects your Facebook and Instagram advertising accounts to Olympus, enabling automated campaign management, audience targeting, and performance tracking. This guide walks you through the complete System User Token flow for secure, long-term API access.

​
Prerequisites

Facebook Account Required

You need an active Facebook account to create a Business Portfolio and complete the integration setup.

​
Step 1: Create a Business Portfolio

Create your Meta Business Portfolio to manage all your business assets in one place.
1

Go to Facebook Business

Navigate to business.facebook.com and sign in with your Facebook account.
2

Create Your Portfolio

Fill in the required form to create your business portfolio with your business name and details.Business Portfolio Creation Form

​
Step 2: Add a Facebook Page

Connect or create a Facebook Page for your business within your portfolio.
1

Navigate to Business Settings

Go to Business Settings in your Business Portfolio dashboard.
2

Access Pages Section

In the sidebar under Accounts, click Pages.Business Settings Pages Section
3

Add a Page

Click Add and choose to Create a new page or Use an existing one.Add Page Options
4

Complete Page Setup

Fill in the form with your page name, category, and other required details to complete page creation.Page Creation Form

​
Step 3: Add an Ad Account and Payment Method

Set up your advertising account with a valid payment method to run campaigns.
1

Access Ad Accounts

In Business Settings, go to Ad Accounts from the sidebar.
2

Add Ad Account

Click Add → Create a new ad account.Ad Accounts Section
3

Configure Account Details

Fill in required details such as Time Zone and Country/Region, then click Create Ad Account.
4

View Payment Methods

After creation, open the dropdown on your ad account and click View Payment Methods.Ad Account Configuration
5

Add Payment Method

Click Add Payment Method and fill in your payment details to enable ad spending.View Payment Methods Option

​
Step 4: Create a Developer App

Create a Meta Developer App to access the Marketing API.
1

Navigate to Apps

In Business Settings, go to Apps.Create New App Option
2

Create a new App ID

Click Add → Create a new App ID.Facebook Developers Portal
3

Access Facebook Developers

You will be redirected to developers.facebook.com to complete app creation.
4

Fill in App Details

Enter your app name and contact email address.App Details Form
5

Select Use Case

Choose Create & manage ads with Marketing API as the use case for your app.Marketing API Use Case Selection
6

Choose Business Portfolio

Select the Business Portfolio you created earlier to associate with this app.Business Portfolio Selection
7

Continue Setup

Click Next to proceed with app creation.App Creation Continue
8

Go to Dashboard

On the Overview step, click Go To Dashboard. Enter your Facebook password when prompted.Go to Dashboard Button

​
Step 5: Configure App Settings and Publish

Configure your app’s privacy policy and publish it to enable full functionality.
1

Navigate to Publish

From the Dashboard sidebar, click Publish.Publish Section in Sidebar
2

Configure Privacy Policy

Click Go to App Settings next to Privacy Policy URL.Privacy Policy Settings Link
3

Add Privacy Policy URL

Enter a valid privacy policy page URL.Privacy Policy URL Input
4

Save Changes

Click Save Changes.Return to Publish Section
5

Return to Publish

Go back to the Publish section in the sidebar.Publish Section in Sidebar
6

Select Use Case

In Use cases on this app, select Create & manage ads with Marketing API.Select Marketing API Use Case
7

Publish Your App

After reviewing Use Case, go back & click Publish to make your app live.Publish App Button

​
Step 6: Create a System User

Create a System User for programmatic API access without personal account dependencies.
1

Access System Users

Go to Business Settings → System Users under the Users section.System Users Section
2

Add System User

Click Add and enter a System User Name (e.g., “Olympus Integration”).Create System User Form
3

Set Admin Role

Set System User Role to Admin and click Create System User.

​
Step 7: Assign Assets to System User

Grant your System User access to the necessary business assets.
1

Click Assign Assets

Select your system user and click Assign Assets.Assign Assets Button
2

Assign Pages

Select Pages → choose your page → turn on Full Access.Assign Page Access
3

Assign Ad Accounts

Select Ad Accounts → choose your ad account → turn on Manage Ad Accounts.Assign Ad Account Access
4

Assign Apps

Select Apps → choose your app → turn on Manage App → click Assign Assets.Assign App Access

​
Step 8: Assign System User to App

Add your System User directly to the app with full control permissions.
1

Navigate to Apps

Go to Apps from the Business Settings sidebar.
2

Assign People

Select your app and click Assign People.Apps Section in Sidebar
3

Add System User

Select the created System User → turn on Manage App (Full Control) → click Assign.Assign People Button

​
Step 9: Generate System User Access Token

Generate a permanent access token for your System User.
1

Return to System Users

Go back to System Users and select your system user.
2

Generate Token

Click Generate Token.System Users List
3

Select App

Select your app from the dropdown and click Next.Generate Token Button
4

Set Token Expiration

Set Expiration to Never and click Next.Select App for Token
5

Select Required Permissions

Select the following permissions required for Olympus integration:
  • ads_management - Create and manage ads
  • ads_read - Read ad account data and insights
  • business_management - Manage business assets and settings
  • pages_show_list - List and access Facebook pages
  • pages_read_engagement - Read page engagement metrics
Click Generate Token after selecting all permissions.Token Permissions Selection
6

Copy Token

Copy the generated token and store it securely. You will need this for the Olympus connection.
Important: Store your access token securely. This token provides full access to your Meta Business assets and should never be shared publicly.

​
Step 10: Connect Meta Integration to Olympus

Complete the integration by connecting your token to Olympus.
1

Navigate to Integrations

Go to Olympus → Integrations from the main navigation.Olympus Integrations Page
2

Connect Meta

Click CONNECT on the Meta integration card.
3

Paste Access Token

Paste your System User Access Token and click CONNECT.Meta Token Input Dialog
4

Connection Complete

Your Meta integration is now connected and ready to use with Olympus.

​
After connecting

​
Disconnect Meta

The Meta card on the Integrations page shows a Connected badge. Manage Meta settings Click Manage in the bottom left corner of the card to open a pop-up where you can disconnect or change your account settings. Disconnect Meta pop-up with change account settings link

​
Changing account settings

To change which Meta ad account or Facebook page Olympus uses for campaigns:
  1. Click Manage on the Meta integration card, then click “or change account settings” at the bottom of the pop-up.
  2. Select your preferred Ad Account and Facebook Page from the dropdowns.
  3. Click Save Changes.
Account Settings dialog for selecting Ad Account and Facebook Page
Only ad accounts and pages associated with your connected Meta Business account will appear in the dropdowns.
System User tokens set to “Never” expiration do not expire, so you will not need to reconnect periodically.
Never share your System User Access Token. If compromised, immediately revoke it from Business Settings and generate a new one.

​
Troubleshooting

If your token stops working, verify that:
  • Your app is still published
  • The System User still has all required asset permissions
  • The token was generated with “Never” expiration
Generate a new token if issues persist.
If certain features don’t work, check that:
  • Your System User has Admin role
  • All assets (Pages, Ad Accounts, Apps) are assigned with full access
  • All permissions were selected during token generation
If API calls fail, ensure your app is published:
  • Go to your app in Facebook Developers
  • Navigate to Publish section
  • Verify the app status shows as “Live”

​
What to do next

Return to Integrations to check your other connections, or start building campaigns in Drive.