{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"snapchat/marketing-api","name":"Snapchat Marketing API (Ads API)","vendor":"Snap","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"OAuth app created in Snap Business Manager (Organization Admin) giving a client id and secret for the Marketing API, under the Snap Developer Terms and Snap Business Tools Terms.","account_model":{"summary":"A Snapchat login with Organization Admin role in a Snap Business Manager organization creates the OAuth app; ad accounts and funding sources live under the organization.","accounts":[{"name":"Snapchat account (login)","kind":"personal","owned_by":"the person","required":true,"note":"Access and refresh tokens are tied to this account, not the organization."},{"name":"Business Manager organization","kind":"organisation","owned_by":"the company","required":true,"note":"You need the Organization Admin role to see the OAuth app dashboard."},{"name":"Ad account","kind":"billing","parent":"Business Manager organization","required":true,"note":"Needs a funding source to run ads."},{"name":"OAuth app","kind":"developer","parent":"Business Manager organization","required":true}]},"prerequisites":[{"need":"Snap Business Manager organization where you are Organization Admin"},{"need":"A funding source and ad account in Business Manager (for running ads through the API)"}],"identity_requires":[],"have_ready":[{"kind":"other","description":"The exact redirect URI your app will use","why":"A redirect_uri cannot be edited after the app is created; a different one needs a new app","needed_for":["create-oauth-app"],"auto_check":"none","source_url":"https://developers.snap.com/marketing-api/Ads-API/faq"},{"kind":"payment_card","description":"Payment method for the ad account's funding source","why":"The Quick Start lists a funding source as a prerequisite","needed_for":["business-manager"],"auto_check":"none","source_url":"https://developers.snap.com/marketing-api/Ads-API/quick-start"}],"steps":[{"id":"business-manager","title":"Sign in to Snap Business Manager","summary":"You sign in, or create the organization, funding source and ad account yourself, as Organization Admin.","route":"guided","gate":"human_login","human_only":true,"gate_label":"You sign in","depends_on":[],"optional":false,"url":"https://business.snapchat.com/","lead_time":null,"preflight":[],"captures":null},{"id":"accept-terms","title":"Agree to the Snap Developer Terms and Business Tools Terms","summary":"You read and accept both sets of terms when activating API access.","route":"guided","gate":"human_terms","human_only":true,"gate_label":"You accept the terms","depends_on":["business-manager"],"optional":false,"url":"https://www.snap.com/en-US/terms/developer","lead_time":null,"preflight":[],"captures":null},{"id":"create-oauth-app","title":"Create the OAuth app in Business Details","summary":"In Business Manager > Business Details > OAuth Apps, enter a name and redirect URI and create the app. You press submit. The client secret is shown only once.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["accept-terms"],"optional":false,"url":"https://business.snapchat.com/","lead_time":null,"preflight":[],"captures":"SNAPCHAT_CLIENT_ID"},{"id":"client-secret","title":"Save the client secret immediately","summary":"Copy the client secret when it is shown; it is displayed only at creation.","route":"guided","gate":"none","human_only":false,"gate_label":null,"depends_on":["create-oauth-app"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":"SNAPCHAT_CLIENT_SECRET"},{"id":"authorize","title":"Authorize and get a refresh token","summary":"Send the user to the authorize URL with scope snapchat-marketing-api, then exchange the code for an access token (60 minutes) and a refresh token. The user approves the consent screen.","route":"guided","gate":"human_login","human_only":true,"gate_label":"You sign in","depends_on":["client-secret"],"optional":false,"url":"https://accounts.snapchat.com/login/oauth2/authorize","lead_time":null,"preflight":[],"captures":"SNAPCHAT_REFRESH_TOKEN"}],"gates":[{"step":"business-manager","gate":"human_login","label":"You sign in"},{"step":"accept-terms","gate":"human_terms","label":"You accept the terms"},{"step":"create-oauth-app","gate":"human_submit","label":"You press submit"},{"step":"authorize","gate":"human_login","label":"You sign in"}],"lead_times":[],"outputs":[{"name":"SNAPCHAT_CLIENT_ID","description":"OAuth client id of the Business Manager app","secret":false,"example_format":"uuid-like string, e.g. 1a2b…","environments":["development","test","staging","production"]},{"name":"SNAPCHAT_CLIENT_SECRET","description":"OAuth client secret (shown only once)","secret":true,"example_format":"random string, e.g. 9f…","environments":["development","test","staging","production"]},{"name":"SNAPCHAT_REFRESH_TOKEN","description":"Refresh token for the authorizing user; does not expire but stops working if that user loses access","secret":true,"example_format":"opaque token, e.g. hC…","environments":["development","staging","production"]}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/snapchat/marketing-api"}