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 19 days 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 OAuth — required permissions explained). 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

Meta scopes Wevion requests:

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 OAuth — required permissions explained for what each scope grants.

Sync data

Wevion syncs from Meta every 15 minutes. 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 Manage Facebook Pages and Instagram accounts.

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