# Snapchat Ads setup for PopMCP

An Organization Admin creates a free OAuth app in Snap Business Manager with PopMCP's redirect URI, enters its Client ID and Client secret in PopMCP, signs in with Snapchat and picks the ad account. Snap does not review the app.

- Auth: OAuth authorization
- Setup time: 4 min
- API base URL: https://adsapi.snapchat.com/v1
- Credentials screen: https://business.snapchat.com/
- Provider docs: https://developers.snap.com/marketing-api/Ads-API/authentication

## Before you begin

- A Snapchat login with a Snap Business account. You need the Organization Admin role to see OAuth Apps. Anyone else in the organization can connect once an admin shares the app's Client ID and secret, and they reach only what their own roles allow.
- An ad account in that organization. To read reports the login needs at least the Reports role on it. To change campaigns it needs General or Admin.
- PopMCP's redirect URI from the connect form: https://app.popmcp.com/api/providers/snapchat-ads/callback

## Get your credentials

### 1. Open Business Details

Go to business.snapchat.com and sign in as an Organization Admin. Open Business Details. If you started in Ads Manager, the menu in the top corner has it too.

Screen: https://business.snapchat.com/

### 2. Create an OAuth app

Find OAuth Apps and create a new app. Name it `PopMCP`. In Snap Redirect URI paste `https://app.popmcp.com/api/providers/snapchat-ads/callback`. Accept the Snap Developer Terms and Snap Business Tools Terms, then create it. Snap reviews nothing, so it works straight away.

Screen: https://business.snapchat.com/

### 3. Copy the Client ID and Client secret

Snap now shows the Client ID and Client Secret. Copy both straight away: the secret is shown only this once. If you lose it, make a new app.

Screen: https://business.snapchat.com/

### 4. Connect in PopMCP and pick the ad account

In PopMCP open Snapchat Ads, enter the Client ID and Client secret, and click Sign in with Snapchat. Approve access on Snapchat's page with the login you use for Ads Manager. Back in PopMCP, pick the ad account: each connection is locked to the one you pick, and another ad account can go in its own workspace.

Screen: https://app.popmcp.com/

## Fields PopMCP asks for

- Client ID (clientId) [required]: Only needed to use your own app. An Organization Admin opens business.snapchat.com, Business Details, finds OAuth Apps and creates an app: name it, paste the Redirect URI shown here, and accept the terms. Snap reviews nothing. Copy the Client ID and Client secret (the secret shows once).
- Client secret (clientSecret) [required]: Shown once when the app is made. Stored encrypted and used only on our server.
- Conversions API token (conversionsToken): Optional. A long-lived token from Business Details, Conversions API Tokens (an Organization Admin can generate one). Without it, conversions are sent with your sign-in.
- Public Profile API (extraPermissions): Only if Snap has allowlisted your app for the Public Profile API (ask your Snap contact): enter snapchat-profile-api. Otherwise leave it blank, or Snap refuses the sign-in.

## Callback URL to register

https://app.popmcp.com/api/providers/snapchat-ads/callback

## Scopes requested

- snapchat-marketing-api
- snapchat-offline-conversions-api

## Verify

PopMCP shows Snapchat Ads as Connected under your ad account's name, and snapchat_ads_get_performance_report returns its spend for the dates you ask about.

## Troubleshooting

### There is no OAuth Apps section on Business Details

Cause: Only Organization Admins see it.

Fix: Ask an admin to make you one under **Members**, or to create the app and share its Client ID and secret with you.

### Snapchat says the redirect URI does not match

Cause: The **Snap Redirect URI** on the app differs from PopMCP's by a character.

Fix: Edit the app and set it to exactly `https://app.popmcp.com/api/providers/snapchat-ads/callback`, then connect again.

### "Snapchat did not accept this app's Client ID and Client secret"

Cause: A mistyped value, or a secret from another app.

Fix: Copy the Client ID again. If you no longer have the secret, create a new OAuth app, since Snap shows it only once.

### The picker says the login has no ad accounts

Cause: The login has no role on any ad account.

Fix: In Business Manager, ask an admin to give you a role under **Ad Accounts**, or create one, then connect again.

### A tool answers 403

Cause: The login's role does not allow it, or the area needs Snap's approval.

Fix: Reports need the Reports role and changes need General or Admin. Public Profile tools need Snap to allowlist the app, and marketing mix reports need Snap to enable them for your organization.

### A tool says an id is not in the ad account this connection is locked to

Cause: The id belongs to another ad account your login can see.

Fix: Use an id from this account's list tools, or connect the other ad account to its own workspace.

### A report answers E9001 or says it is too large

Cause: Snap limits how much a direct stats answer can hold.

Fix: Ask for fewer days or fields, or use async=true with the matching stats_report tool.

---

Source: https://www.docs.popmcp.com/docs/integrations/snapchat-ads/