{"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"},"entry_sha256":"8580b4fb2a473c165cf0eea9e111f06f297ead55d598baae161f43061f428586","entry":{"id":"snapchat/marketing-api","name":"Snapchat Marketing API (Ads API)","vendor":"Snap","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.","aliases":["snapchat","snap-ads-api","snap-marketing-api"],"category":"social","group":"C","homepage":"https://developers.snap.com/marketing-api/Ads-API/introduction","docs":["https://developers.snap.com/marketing-api/Ads-API/authentication","https://developers.snap.com/marketing-api/Ads-API/quick-start","https://developers.snap.com/marketing-api/Ads-API/rate-limits","https://developers.snap.com/marketing-api/Ads-API/faq"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"snap-auth","url":"https://developers.snap.com/marketing-api/Ads-API/authentication","title":"Snap – Marketing API Authentication","accessed":"2026-10-25","supports":"OAuth apps set up in Business Details in Snap Business Manager; Organization Admin needed; must agree to Snap Developer Terms and Snap Business Tools Terms; name and redirect_uri; client_id and client_secret, secret only displayed at creation; scopes; authorize and token endpoints; access token valid 3600 seconds, refreshed with refresh token","kind":"official"},{"id":"snap-quick-start","url":"https://developers.snap.com/marketing-api/Ads-API/quick-start","title":"Snap – Marketing API Quick Start","accessed":"2026-10-25","supports":"Prerequisites are Business Manager access, Organization Admin role, an OAuth app, an organization, a funding source and an ad account; creatives start PENDING_REVIEW","kind":"official"},{"id":"snap-faq","url":"https://developers.snap.com/marketing-api/Ads-API/faq","title":"Snap – Marketing API FAQ","accessed":"2026-10-25","supports":"Refresh token does not expire but stops working if the user loses access; redirect_uri cannot be edited; test=true for dummy reporting data","kind":"official"},{"id":"snap-rate-limits","url":"https://developers.snap.com/marketing-api/Ads-API/rate-limits","title":"Snap – Marketing API Rate Limits","accessed":"2026-10-25","supports":"About 20 requests/second per app and 10 requests/second per access token; HTTP 429 when exceeded","kind":"official"},{"id":"snap-developer-terms","url":"https://www.snap.com/en-US/terms/developer","title":"Snap Developer Terms (effective January 31, 2025)","accessed":"2026-10-25","supports":"No sharing keys or tokens; no charging for access to the program; no building profiles or segments from Business Services Data; security programme required; Snap may audit; Snap need not approve your application; delete data on request or termination; no public statements about access without approval","kind":"official"},{"id":"snap-business-tools-terms","url":"https://www.snap.com/en-US/terms/snap-business-tools","title":"Snap Business Tools Terms (effective November 1, 2021)","accessed":"2026-10-25","supports":"Covers APIs and keys; Business Services Data used only to provide that Customer access; retention limited to legitimate business need and never over 36 months; report data loss immediately; show spend separately from your fees; partner apps need Snap's prior written approval of UI and metrics; Customer agreements must require compliance","kind":"official"},{"id":"snap-api-apply","url":"https://businesshelp.snapchat.com/s/article/api-apply?language=en_US","title":"Snapchat Business Help – Accessing Snapchat Marketing API","accessed":"2026-10-25","supports":"Step-by-step app creation in Business Manager (page did not render for direct fetch; up to 10 redirect URIs per search index) [to verify]","kind":"official"}],"allowed_domains":["business.snapchat.com","developers.snap.com","businesshelp.snapchat.com","accounts.snapchat.com","www.snap.com"],"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)"}],"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":"snap-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":"snap-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","depends_on":[],"gate":"human_login","url":"https://business.snapchat.com/","sources":["snap-quick-start"]},{"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","depends_on":["business-manager"],"gate":"human_terms","url":"https://www.snap.com/en-US/terms/developer","sources":["snap-auth","snap-developer-terms","snap-business-tools-terms"]},{"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","depends_on":["accept-terms"],"gate":"human_submit","url":"https://business.snapchat.com/","recovery":[{"hiccup":"The OAuth Apps section is not visible","fix":"Ask an Organization Admin to grant you that role","source":"snap-faq"},{"hiccup":"Need a different redirect URI","fix":"Create a new app; an existing redirect_uri cannot be edited","source":"snap-faq"}],"capture":{"env":"SNAPCHAT_CLIENT_ID","kind":"client_id"},"sources":["snap-auth","snap-api-apply"]},{"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","depends_on":["create-oauth-app"],"gate":"none","capture":{"env":"SNAPCHAT_CLIENT_SECRET","kind":"secret"},"sources":["snap-auth"]},{"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","depends_on":["client-secret"],"gate":"human_login","url":"https://accounts.snapchat.com/login/oauth2/authorize","capture":{"env":"SNAPCHAT_REFRESH_TOKEN","kind":"token"},"sources":["snap-auth","snap-faq"]}],"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"],"from_step":"create-oauth-app"},{"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"],"from_step":"client-secret"},{"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"],"from_step":"authorize"}],"terms_notes":[{"kind":"rules_say","severity":"red","title":"Business Services Data is for serving that customer only","text":"You may not use Business Services Data for your own or a third party's benefit except to provide that customer access to Snap's Business Services, and may not build profiles or segments from it. Keep it only as long as a legitimate business need requires and never more than 36 months.","source":"snap-business-tools-terms"},{"kind":"rules_say","severity":"amber","title":"No sharing credentials or charging for access","text":"Do not share keys, credentials or access tokens, and do not charge for access to the Snap Developer Program. Snap may audit you and need not approve or distribute your application.","source":"snap-developer-terms"},{"kind":"rules_say","severity":"amber","title":"Agencies and partners","text":"Show customers what they spent through Snap separately from your own fees. Partner apps need Snap's prior written approval of aspects such as UI and displayed metrics, and binding customer agreements requiring compliance.","source":"snap-business-tools-terms"},{"kind":"rules_say","severity":"amber","title":"Deletion on request or termination","text":"Promptly delete Snap Confidential Information and Business Services Data when Snap asks or on termination, and certify deletion if asked.","source":"snap-developer-terms"},{"kind":"rules_say","severity":"yellow","title":"Publicity and brand","text":"No public statements about your access without Snap's approval; no use of Snap Brand Features in advertising. Snap may use your name and logo for business purposes.","source":"snap-developer-terms"},{"kind":"rules_say","severity":"yellow","title":"Rate limits","text":"About 20 requests/second per app and 10 requests/second per access token; exceeding returns HTTP 429.","source":"snap-rate-limits"}],"pricing_notes":{"free_tier":"No API access fee found in official docs [to verify]","costs":"Ad spend through the ad account's funding source","notes":"The Quick Start requires a funding source and ad account to run ads.","source":"snap-quick-start"},"stripe_projects":false,"api_provisioning":{"available":"no","notes":"OAuth apps are created manually in Business Manager; tokens come from the OAuth flow.","docs":["https://developers.snap.com/marketing-api/Ads-API/authentication"],"source":"snap-auth"},"notes":["No formal app review step for the Marketing API was found in current official docs; Snap's Developer Terms say Snap need not approve your application [to verify whether any review applies].","The Business Help article (api-apply) did not render on direct fetch; its details came from search index text [to verify].","The Public Profile API is separate and allowlist-only; not covered here.","Other scopes exist (snapchat-offline-conversions-api, snapchat-profile-api); only snapchat-marketing-api is covered.","Developer Terms and Business Tools Terms say nothing explicit about AI/ML training."]}}