Connect Meta (Facebook + Instagram) at /connect/meta. OAuth with Business Manager, asset selection, 15-min sync.

Connect your Meta (Facebook & Instagram) account

Open /connect/meta, click Connect, sign in to Facebook with your Business Manager user, grant the requested permissions, pick which ad accounts and Facebook Pages to import. Within 15 minutes your data starts flowing into the Wevion dashboard.

Who is this for

Mediabuyers, admins, owners, and super_admins setting up the Meta integration for the first time. The mediabuyer role or an admin/owner/super_admin role is required to connect a new platform (the manager role is not allowed on the connect page).

Before you start

You need:

• A Facebook user account that has Business Manager admin access on at least one BM containing your ad accounts
• Browser pop-ups enabled for app.wevion.ai (the OAuth flow opens a Facebook popup)
• The Wevion role mediabuyer, admin, owner, or super_admin (per team-101 roles reference)

How to connect

Step 1: Open the connector page

In the sidebar click Connect → Meta or jump to /connect/meta. The page shows what permissions Wevion will request, plus a list of any already-connected Meta users.

Step 2: Click Connect

Click the Connect button (top right). A popup opens to Facebook's official OAuth dialog.

Step 3: Sign in to Facebook and authorize

In the popup:

• Log in with your Facebook account (the one with Business Manager access)
• Facebook shows the permissions Wevion is requesting — the full list of scopes Wevion asks for is in meta-102
• Click Continue as [your name]
• Pick which Business Manager(s) to share with Wevion (Facebook prompts this if you have multiple)
• Click Continue

The popup closes and returns you to Wevion.

Step 4: Select assets to import

Wevion fetches your accessible assets and shows two lists:

• Ad accounts: tick the ones to manage in Wevion
• Facebook Pages (also called Fan Pages): tick which to import for Page-as-source ads + Instagram placements

Click Import selected. Backend creates meta_token, meta_ad_account, and meta_fan_page rows in your workspace (the OAuth access token is stored in the meta_token.access_token column).

Step 5: Wait for the first sync

Sync runs every 15 minutes. The first sync pulls last 90 days of: campaigns, ad sets, ads, creatives, custom audiences, pixels, conversion events. For a typical workspace (10-50 ad accounts) the first sync takes 10-30 minutes.

You can leave the page and come back. The connector card shows status per account: Syncing, Synced, Error.

What you'll see when it works

• Connector card: Connected badge (green)
• Account count visible (e.g. "5 ad accounts imported")
• The dashboard at /dashboard populates within 15-30 minutes
• Ads Manager at /ads-manager shows the imported campaigns
• Toast: "Imported N campaigns from Meta"

Pixels and Conversions API

Pixels are imported automatically — they appear at /pixels with health status. The Conversions API runs as Wevion's built-in server-side tracking pipeline rather than a per-account setup you configure in the UI. For the pixel side see meta-105 pixels and CAPI setup.

Connecting multiple Meta users

Different teammates can each connect their own Meta user. Wevion accumulates the union of all teammates' Meta permissions. Useful when no single Meta user has access to all ad accounts.

To add a second Meta user from the same team, the new teammate logs in to Wevion and follows steps 1-5 — Wevion stores a separate meta_token record per teammate's Facebook session.

Reconnecting after token expiry

Long-lived Meta user tokens expire (Meta's policy). A background job runs every 12 hours and refreshes any user token due to expire within the next 7 days, using Meta's token-exchange endpoint. If a refresh fails (you changed Facebook password, revoked the Wevion app, account suspended), the connector card turns yellow with a Reconnect button and Wevion raises an in-app Token expired notification. Click Reconnect to redo OAuth without data loss. See meta-107 token health.

Common issues

• OAuth popup blocked: enable popups for app.wevion.ai in browser settings, then retry.
• "No ad accounts found": you signed in with a Facebook user without Business Manager access. Sign out of Facebook, sign back in with a BM admin account, retry Connect.
• Sync stuck on "Syncing" > 1 hour: usually Meta API rate limit. Wait 30 min, refresh card. Persistent issues: see meta-108 troubleshooting.
• Page missing from import: the Facebook user lacks the Page admin or editor role. Ask the Page admin to grant access in Meta Business Manager.
• Connection fails after "Continue as [name]": Wevion's Facebook app may not have the BM whitelisted (rare). Contact support@wevion.ai with your Business Manager ID.
• Duplicate accounts in import list: multiple BMs share access to the same ad account. Pick whichever; the import is per-account, not per-BM.

Security and data access

• Token stored in the meta_token.access_token column and used only by backend services to make Meta API calls on your workspace's behalf; masked in logs
• Wevion requests the scopes listed in meta-102 — no personal profile data beyond the OAuth identifier and email, no posts, no friend list
• Wevion never posts on your behalf

FAQ

What role do I need to connect Meta to Wevion?

You need the Wevion role mediabuyer, admin, owner, or super_admin to connect a new platform — the manager role is not permitted on the connect page, while mediabuyer is. On the Meta side, sign in with a Facebook user that has Business Manager admin access on at least one BM containing your ad accounts. A viewer or finance role cannot set up the Meta integration.

How long does the first Meta sync take in Wevion?

Sync runs every 15 minutes, and the first cycle pulls the last 90 days of campaigns, ad sets, ads, creatives, custom audiences, pixels, and conversion events. For a typical workspace of 10-50 ad accounts, the first sync takes 10-30 minutes. Your /dashboard populates within 15-30 minutes and the connector card shows Syncing, Synced, or Error.

Why does Wevion say "No ad accounts found" after connecting Meta?

This means you signed in with a Facebook user that lacks Business Manager access. Sign out of Facebook, sign back in with a BM admin account, then retry the Connect flow at /connect/meta. Wevion can only import ad accounts your authenticated Meta user can reach in Business Manager.

Does Wevion post to my Facebook or read personal data?

No. Wevion never posts on your behalf. It requests the scopes listed in meta-102 — no posts and no friend list. Your token is stored in the meta_token.access_token column, used only by backend services for API calls on your workspace's behalf, and masked in logs.

Can multiple teammates connect their own Meta accounts?

Yes. Different teammates can each connect their own Meta user, and Wevion accumulates the union of all their Meta permissions. This is useful when no single Meta user has access to all ad accounts. Each teammate logs in to Wevion and follows the same connect steps; Wevion stores a separate meta_token record per Facebook session.

Related articles

• Meta OAuth — required permissions explained
• Manage your Meta ad accounts
• Connect your first ad platform