Connect Snapchat

Snapchat is env-gated in Wevion — contact support if Connect button hidden. When enabled: OAuth at /connect/snapchat.

Written By Salvatore Sinigaglia

Last updated About 5 hours ago

Snapchat is env-gated in Wevion — contact support if Connect button hidden. When enabled: OAuth at /connect/snapchat.

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

FAQ

Why can't I see the Connect Snapchat button in Wevion?

Because Snapchat is environment-gated in Wevion. The connector requires SNAPCHAT_ENABLED=true plus a non-empty client ID and secret, all set server-side. If any is missing, the frontend hides the Connect Snapchat entry point and the backend returns 503. If you don't see the option, it's not enabled for your deployment — contact support@wevion.ai or your CSM.

What does Wevion import from Snapchat on first sync?

The first 15-minute sync pulls campaigns, ad squads, ads, audiences, pixels, and the last 90 days of insights. Wevion also fetches your accessible Snap ad accounts (organizations) right after OAuth so you can tick which to import. When it works, the connector card turns green and Ads Manager shows your Snap campaigns.

Does Wevion access my personal Snapchat content?

No. Wevion's Snap scopes are limited to ad management and reporting — it has no access to personal Snapchat content such as Snaps, Stories, or Friends. Tokens are encrypted at rest with a dedicated key, and you can revoke access anytime at Snap Ads Manager → Account → Connected Apps.

How does Wevion keep my Snapchat token valid?

Wevion auto-refreshes your Snapchat token via the REFRESH_SNAPCHAT_TOKENS cron worker. At OAuth, Snapchat returns an access token with an expiry plus a refresh token, and Wevion stores them encrypted at rest. If a refresh fails, the connector card turns yellow — just reconnect via the card button to restore sync.

Does audience size matter more on Snapchat?

Yes. Snap requires larger audiences (over 1,000) to serve effectively due to its user-base size, so plan targeting accordingly. Snap is also video-first — its ad format heavily favors vertical video — and reaches under-25 audiences strongly while older demographics are weaker. AR Lens ads are a unique Snap format Wevion can manage.

FAQ

Why can't I see the Connect Snapchat button in Wevion?

Because Snapchat is environment-gated in Wevion. The connector requires SNAPCHAT_ENABLED=true plus a non-empty client ID and secret, all set server-side. If any is missing, the frontend hides the Connect Snapchat entry point and the backend returns 503. If you don't see the option, it's not enabled for your deployment — contact support@wevion.ai or your CSM.

What does Wevion import from Snapchat on first sync?

The first 15-minute sync pulls campaigns, ad squads, ads, audiences, pixels, and the last 90 days of insights. Wevion also fetches your accessible Snap ad accounts (organizations) right after OAuth so you can tick which to import. When it works, the connector card turns green and Ads Manager shows your Snap campaigns.

Does Wevion access my personal Snapchat content?

No. Wevion's Snap scopes are limited to ad management and reporting — it has no access to personal Snapchat content such as Snaps, Stories, or Friends. Tokens are encrypted at rest with a dedicated key, and you can revoke access anytime at Snap Ads Manager → Account → Connected Apps.

How does Wevion keep my Snapchat token valid?

Wevion auto-refreshes your Snapchat token via the REFRESHSNAPCHATTOKENS cron worker. At OAuth, Snapchat returns an access token with an expiry plus a refresh token, and Wevion stores them encrypted at rest. If a refresh fails, the connector card turns yellow — just reconnect via the card button to restore sync.

Does audience size matter more on Snapchat?

Yes. Snap requires larger audiences (over 1,000) to serve effectively due to its user-base size, so plan targeting accordingly. Snap is also video-first — its ad format heavily favors vertical video — and reaches under-25 audiences strongly while older demographics are weaker. AR Lens ads are a unique Snap format Wevion can manage.

Last updated: 2026-05-17