Connect Snapchat

Last updated: May 19, 2026

Connect Snapchat

Snapchat is environment-gated in Wevion (verified in apps/backend/src/lib/snapchat-feature-flag.ts). If your workspace doesn't see the Connect Snapchat button, the feature flag is off — contact support@wevion.ai to enable. When enabled: OAuth flow at /connect/snapchat, similar to other platforms.

Who is this for

Mediabuyers running Snap Ads campaigns. Snapchat is a smaller part of most media stacks but valuable for Gen Z + young millennial audiences, AR experiences, and creator-driven brand campaigns.

Why Snapchat is env-gated

Wevion's Snapchat connector requires three things, all set server-side:

  • SNAPCHAT_ENABLED=true

  • SNAPCHAT_CLIENT_ID non-empty

  • SNAPCHAT_CLIENT_SECRET non-empty

If any is missing:

  • Backend returns 503 for Snapchat endpoints

  • Frontend hides the Connect Snapchat entry point (Vite flag SNAPCHAT_ENABLED)

  • Backend gate (isSnapchatEnabled()) prevents direct API calls from third parties (curl, postman)

This is defense-in-depth — connecting to Snapchat without proper Snap creds would fail at the API layer with a confusing error. The feature flag surfaces a clean disabled state instead.

If you don't see the Connect Snapchat option in your Wevion workspace, it's not enabled for your deployment. Contact support@wevion.ai or your CSM to discuss enabling.

When enabled — how to connect

Step 1: Open the connector page

In the sidebar click Connect → Snapchat (visible only if env enabled) or visit /connect/snapchat.

Step 2: Click Connect

A Snapchat OAuth popup opens (SNAPCHAT_AUTHORIZE_URL per apps/backend/src/providers/snapchat/core/constants.ts).

Step 3: Sign in to Snap Ads Manager

Use your Snap Ads Manager credentials. Snapchat shows the scopes Wevion requests (defined by getSnapchatScopes() in apps/backend/src/providers/snapchat/domains/auth.provider.ts — typically ad management + reporting scopes).

Click Authorize.

Step 4: Asset selection

After OAuth, Wevion fetches accessible Snap ad accounts (organizations). Tick which to import.

Step 5: First sync

15-min sync runs. Pulls campaigns, ad squads, ads, audiences, pixels, last 90 days insights. Snapchat-specific entities: organizations, ad accounts within organizations.

Wevion handles asset sync via apps/backend/src/services/snapchat-asset-sync.service.ts + insight collection via snapchat-insight-collector.service.ts.

What you'll see when it works

  • Connector card: green Connected

  • Snap ad account count visible

  • Dashboard populates with Snap data

  • Ads Manager shows Snap campaigns

  • Toast: "Imported N campaigns from Snapchat"

Snap Pixel

Snapchat has a tracking pixel similar to Meta Pixel. Auto-imported from connected ad accounts. See snp-102.

Token model

  • Access token with expires_in returned at OAuth

  • Refresh token issued

  • Wevion auto-refreshes via REFRESH_SNAPCHAT_TOKENS cron worker (verified in apps/backend/src/services/snapchat-auth.service.ts)

  • Encrypted at rest via SNAPCHAT_TOKEN_ENCRYPTION_KEY env

When the connector card stays disabled

If the connector card shows Snapchat: feature disabled with no Connect button:

  • The env vars aren't configured for your deployment

  • Contact support — they'll let you know if/when Snapchat is available for your plan

For some plans, Snapchat may require:

  • Specific subscription tier

  • Custom contract addendum

  • Wait for general availability rollout

Common issues (when enabled)

  • "snapchat_disabled" 503 error: env not configured. Contact support.

  • OAuth popup blocked: allow popups for app.wevion.ai.

  • "No ad accounts found": your Snap user has no organization role. Verify in Snap Ads Manager.

  • Token refresh failed: reconnect via yellow card.

  • Sync stuck > 1h: Snap API rate limit. Wait + retry.

Security

  • Token encrypted at rest with dedicated key

  • Wevion's Snap scopes limited to ad management + reporting

  • No personal Snapchat content access (Snaps, Stories, Friends)

  • Revoke at Snap Ads Manager → Account → Connected Apps

Snapchat's quirks vs other platforms

  • Audience size matters more on Snap: Snap requires larger audiences (>1.000) to serve effectively due to user-base size

  • Video-first: Snap's ad format heavily favors vertical video. Plan creative accordingly

  • AR Lens ads: a unique Snap format. Wevion can manage delivery but creative assets must be built in Snap Lens Studio

  • Gen Z reach: under-25 audience strong; older demographics weaker on Snap

Related