Connect & manage Meta Ads with Wevion — complete guide

Meta integration: OAuth connect, ad accounts, scopes, sync, manage campaigns, troubleshoot. Mediabuyer + admin index for Meta Ads in Wevion.

Written By Salvatore Sinigaglia

Last updated About 5 hours ago

Meta integration: OAuth connect, ad accounts, scopes, sync, manage campaigns, troubleshoot. Mediabuyer + admin index for Meta Ads in Wevion.

Connect & manage Meta Ads with Wevion — complete guide

TL;DR: Wevion's Meta integration uses OAuth with the META_SCOPES set (ads read/write, Pages, linked Instagram, catalogs, Business Manager — full list in meta-102). Connect → pick accounts → 15-min sync → manage via Campaign Creator + Ads Manager + Rules + Analytics. Meta is the most-supported platform (write actions enabled; all six platforms read).

Table of contents

Connect Meta account (OAuth)

/connect/meta → OAuth consent screen → grant permissions → the OAuth access token is stored in the meta_token table in Wevion's DB.

OAuth flow includes business validation + ad-account selection.

Pick ad accounts

After OAuth: Wevion lists ad accounts visible to your Meta user. Pick which to manage in Wevion (typically all relevant for your team).

Per-account: data syncs independently, can be enabled / disabled.

Permissions + scopes

Verified scopes (per apps/backend/src/providers/meta/core/constants.ts, META_SCOPES):

ScopePurpose
emailOAuth identity email
ads_managementRead + write ads, campaigns, ad sets, audiences
ads_readRead-only ads/insights access
instagram_basicRead linked Instagram account basics
pages_manage_adsManage ads tied to your Pages
pages_read_engagementRead page-level data
pages_show_listList the Pages you manage
catalog_managementRead/manage product catalogs
read_insightsRead Page/ads insights metrics
business_managementAccess Business Manager structure (accounts, users)

These scopes fall into three functional groups — the minimum an ad-management tool needs: manage campaigns (ads_management, pages_manage_ads), read performance/insights (ads_read, read_insights), and manage accounts & assets (business_management, pages_read_engagement, pages_show_list, instagram_basic, catalog_management, email). No friend list, no posting on your behalf.

A background job auto-refreshes user tokens due to expire within 7 days; full re-auth is required on permission change OR after a refresh failure. See meta-102 for what each scope grants.

Sync data

Cron syncs from Meta every 15 minutes (apps/backend/src/sqs/workers/sync/). Insights flow into:

  • campaign_daily_insight (per-day, per-campaign)
  • adset_daily_insight
  • ad_daily_insight

Postback conversions lag 24-72h. See am-121 postback vs Meta conversions.

Manage campaigns

Once connected, full lifecycle in Wevion:

Meta-only actions:

  • relaunch rule action (copy ad with new creative — Meta-only)

Troubleshoot

Connection issues, sync failures, permission errors:

Common: token expired → re-auth via /connect/meta. See tr-109 token expired.

FAQ

Can I connect multiple Meta accounts?

Yes. Connect once (OAuth flow) → pick multiple ad accounts. Wevion manages each independently. For multi-Business-Manager scenarios: connect each via separate flow.

What if I lose access to my Meta user?

Re-authorize via OAuth flow with new Meta user. Wevion re-picks accessible accounts.

Does Wevion work with Instagram Ads?

Yes. Instagram is surfaced through your linked Facebook Page (Wevion requests instagram_basic and manages Page-linked IG ads). See meta-104.

Does Wevion work with WhatsApp Ads?

No. Wevion's Meta integration covers Facebook and Instagram placements through your Pages and ad accounts; it does not request a WhatsApp scope and does not manage WhatsApp Business messaging or WhatsApp-specific ad flows.

Token expiring notification?

Wevion tracks each token's expiry and a background job auto-refreshes user tokens due within 7 days. If a refresh fails, Wevion raises an in-app Token expired notification and re-auth is needed. See tr-109 token expired.

Sync frequency?

Every 15 minutes per Wevion cron. Postback conversions lag separately (24-72h via Meta API).

iOS 14.5+ ATT impact?

Meta's iOS ATT limits per-user attribution. Use postback / tracker data for fuller picture. See am-121 postback vs Meta conversions.

Next steps