Understanding Meta Authorization & Permissions

Overview

When you connect Agency AI to your Meta (Facebook) account, Meta's authorization system asks you to grant specific permissions. This guide explains what each permission does, why Agency AI needs it, and how to ensure you're granting the correct access.

How Meta Authorization Works

Meta uses a standard authorization protocol called OAuth. When you click "Connect to Meta" inside Agency AI, a pop-up window opens where Meta handles the entire authorization process. Agency AI never sees or stores your Facebook login credentials — Meta simply provides Agency AI with a secure access token after you approve the connection.

This access token allows Agency AI to interact with your Meta advertising assets on your behalf, within the boundaries of the permissions you grant.

Permissions Agency AI Requests

During the authorization flow, Meta will display the permissions Agency AI is requesting. Here's what each one means:

Business Management Access — Allows Agency AI to see which Meta Business account you're associated with and access its settings. This is necessary for identifying your connected assets.

Ad Account Access — Allows Agency AI to create, edit, pause, and manage ad campaigns within your selected Ad Account. This is the core permission that enables Agency AI to launch and optimize ads on your behalf.

Page Access — Allows Agency AI to view your connected Facebook Page. Your Page is required for running ads, as all Facebook and Instagram ads must be associated with a Page.

Pixel Data Access — Allows Agency AI to read event data from your Meta Pixel. This data (page views, add-to-carts, purchases) is what Agency AI uses to optimize your campaigns for conversions and calculate ROAS.

Catalog Access — Allows Agency AI to read your product catalog for dynamic product ads. This enables features like retargeting visitors with the specific products they viewed on your store.

Granting Permissions Correctly

During the Meta authorization pop-up, you'll be presented with a series of screens where you select which specific assets to share. Pay attention to the following:

• Select the correct Business Account. If you manage multiple businesses, make sure you're choosing the one associated with your Shopify store.
• Select all required asset types. Skipping an asset (such as your Pixel or Page) will result in a partial connection and may cause errors within Agency AI.
• Use an account with admin access. If you're logged into a personal Facebook account that doesn't have admin access to your Business assets, the authorization will fail or connect to the wrong assets.

What Happens If You Deny a Permission

If you skip or deny any of the requested permissions, Agency AI may not function correctly. Common symptoms of missing permissions include:

• Inability to create or launch ad campaigns
• Missing conversion data or ROAS tracking
• Errors when attempting to sync your product catalog
• Dashboard showing "disconnected" status for certain assets

If you suspect a permissions issue, you can disconnect and reconnect your Meta account within Agency AI to go through the authorization flow again.

Revoking Access

You can revoke Agency AI's access to your Meta account at any time:

1. Go to Facebook Settings > Business Integrations.
2. Find Agency AI in the list of connected apps.
3. Click "Remove" to revoke all permissions.

After revoking access, Agency AI will no longer be able to manage your ads until you reconnect.

Security & Privacy

Agency AI takes your data security seriously. Your Meta access token is encrypted and stored securely. Agency AI only accesses the data necessary to manage your ad campaigns and never shares your Meta data with third parties. You remain in full control of your Meta assets at all times.