Connect your Meta (Facebook & Instagram) account

Last updated: May 19, 2026

Connect your Meta (Facebook & Instagram) account

Open /connect/meta, click Connect, sign in to Facebook with your Business Manager user, grant 3 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, managers, admins, and owners setting up the Meta integration for the first time. Manager role or higher is required to connect a new platform.

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 manager, 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: ads_management, pages_read_engagement, business_management (see meta-102 for what each does)

  • 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 (encrypted token via META_TOKEN_ENCRYPTION_KEY).

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. Conversions API (CAPI) setup requires extra steps per ad account — 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_user record per teammate's Facebook session.

Reconnecting after token expiry

Meta tokens expire approximately every 60 days. Wevion auto-refreshes silently. If refresh fails (you changed Facebook password, revoked the Wevion app, account suspended), the connector card turns yellow with a Reconnect button. Click it 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 encrypted at rest (META_TOKEN_ENCRYPTION_KEY env)

  • Never visible to Wevion staff; masked in logs

  • Wevion only requests the 3 scopes listed in meta-102 — no personal profile data, no posts, no friend list

  • Wevion never posts on your behalf

Related