{"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":"meta/marketing-api","name":"Meta Marketing API","vendor":"Meta","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Create, manage and report on Facebook and Instagram ads by API. Starts at Limited Access (heavily rate-limited, development only); Full Access needs App Review plus 500+ calls in 15 days at under 15% errors.","account_model":{"summary":"A Business Portfolio owns the ad account(s), the Meta app and the system user. The app gets the Marketing API product (Limited Access by default). A system user in the portfolio, assigned to the app and the ad account, holds the non-expiring token your server uses.","accounts":[{"name":"Meta developer account","kind":"developer","owned_by":"the person","required":true},{"name":"Meta Business Portfolio","kind":"organisation","owned_by":"the business","required":true},{"name":"Ad account","kind":"billing","owned_by":"the business (or each client business)","parent":"Meta Business Portfolio","required":true,"note":"Must be active with a payment method to run campaigns. Each advertiser or client needs its own ad account."},{"name":"Meta app with Marketing API product","kind":"project","parent":"Meta Business Portfolio","required":true},{"name":"System user","kind":"other","parent":"Meta Business Portfolio","required":false,"note":"Limited Access allows 1 system user and 1 admin system user; Full Access allows 10 plus 1 admin."}],"notes":["Managing only your own business's ad accounts works at Limited Access with system users. Managing other people's ad accounts needs Advanced (Full) Access to ads_read / ads_management via App Review.","Meta renamed tiers in 2026 docs, Standard to Limited and Advanced to Full; older docs and dashboards may still use the old names."]},"prerequisites":[{"entry":"meta/developer-app"},{"entry":"meta/business-portfolio"},{"entry":"meta/app-review","note":"For Full Access and for ads_read / ads_management on other people's ad accounts."},{"entry":"meta/business-verification","note":"Required if the app accesses sensitive data, and commonly for Advanced Access."}],"identity_requires":["legal_name","website","privacy_policy_url","support_email"],"have_ready":[{"kind":"payment_card","description":"Payment method on the ad account (entered by you on Meta's page)","why":"An active ad account is needed to run campaigns and manage billing","needed_for":["ad-account"],"auto_check":"none","source_url":"https://developers.facebook.com/docs/marketing-api/get-started"},{"kind":"app_privacy_policy_url","description":"Public privacy policy URL for the app","why":null,"needed_for":["create-app"],"auto_check":"website_live","source_url":"https://developers.facebook.com/terms/"},{"kind":"demo_video","description":"Screencast of how the app uses ads_read / ads_management (only for App Review)","why":null,"needed_for":["full-access"],"auto_check":"none","source_url":null},{"kind":"other","description":"A real integration that will make 500+ Marketing API calls in 15 days with under 15% errors","why":"Eligibility threshold for Full Access","needed_for":["full-access"],"auto_check":"none","source_url":"https://developers.facebook.com/docs/marketing-api/overview/authorization"}],"steps":[{"id":"ad-account","title":"Have an active ad account in your Business Portfolio","summary":"Create or find the ad account in Ads Manager / Business settings and add a payment method yourself. Note its number (shown in Ads Manager > Settings > Account overview); the API uses it as act_<number>.","route":"guided","gate":"human_payment","human_only":true,"gate_label":"You add payment details","depends_on":[],"optional":false,"url":"https://adsmanager.facebook.com/","lead_time":null,"preflight":[],"captures":null},{"id":"create-app","title":"Create a Business app with the Marketing API product","summary":"In the App Dashboard create a Business-type app connected to your portfolio and add Marketing API (the \"create and manage ads\" use case [to verify label]). This gives Limited Access straight away.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":[],"optional":false,"url":"https://developers.facebook.com/apps/","lead_time":null,"preflight":[],"captures":null},{"id":"system-user-token","title":"Create a system user and generate a token","summary":"In Business settings > Users > System users, create a system user, assign it the app and the ad account, and generate a token with ads_read and/or ads_management. System user tokens do not expire. Shown once: verapli captures it.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["ad-account","create-app"],"optional":false,"url":"https://business.facebook.com/settings/system-users","lead_time":null,"preflight":[],"captures":"META_ADS_ACCESS_TOKEN"},{"id":"build-and-call","title":"Build and run the integration at Limited Access","summary":"Develop against your own ad account. Expect tight limits (ad account score cap 60 with a 300 s block; Ads Management 300 per hour plus 40 per active ad). Keep error rates low; they count towards Full Access.","route":"guided","gate":"none","human_only":false,"gate_label":null,"depends_on":["system-user-token"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"full-access","title":"Request Full Access (Marketing API Access Tier) through App Review","summary":"Once the app has made 500+ calls in the past 15 days with under 15% errors in the last 500, request the Marketing API Access Tier feature (and Advanced Access to ads_read / ads_management if you manage other people's ad accounts) under App Review > Permissions and Features.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["build-and-call"],"optional":true,"url":"https://developers.facebook.com/apps/","lead_time":{"official":{"text":"No review time stated on the authorization page [to verify]","source_url":"https://developers.facebook.com/docs/marketing-api/overview/authorization","source_title":"Marketing API – Authorization"},"reported":{"text":"Third-party reports put general Meta App Review at around 20 days by mid-2026 (not official, not specific to Marketing API)","source_url":"https://bundle.social/blog/meta-app-review-20-days","source_title":"bundle.social – Meta App Review taking 20 days (July 2026)"},"typical_minutes":null},"preflight":[],"captures":null}],"gates":[{"step":"ad-account","gate":"human_payment","label":"You add payment details"},{"step":"create-app","gate":"human_submit","label":"You press submit"},{"step":"system-user-token","gate":"human_submit","label":"You press submit"},{"step":"full-access","gate":"third_party_review","label":"The provider reviews it"}],"lead_times":[{"step":"full-access","what":"Request Full Access (Marketing API Access Tier) through App Review","official":{"text":"No review time stated on the authorization page [to verify]","source_url":"https://developers.facebook.com/docs/marketing-api/overview/authorization","source_title":"Marketing API – Authorization"},"reported":{"text":"Third-party reports put general Meta App Review at around 20 days by mid-2026 (not official, not specific to Marketing API)","source_url":"https://bundle.social/blog/meta-app-review-20-days","source_title":"bundle.social – Meta App Review taking 20 days (July 2026)"}}],"outputs":[{"name":"META_ADS_ACCESS_TOKEN","description":"System user access token with ads_read / ads_management (does not expire)","secret":true,"example_format":"EAA…","environments":["development","production"]},{"name":"META_AD_ACCOUNT_ID","description":"Ad account id used in API paths","secret":false,"example_format":"act_1234567890","environments":null},{"name":"META_ADS_APP_ID","description":"App ID of the Meta app with the Marketing API product","secret":false,"example_format":"1234567890123456","environments":null}],"renewals":[{"what":"Data Use Checkup for apps with Advanced Access","every":"1 year","every_days":365,"source_url":"https://developers.facebook.com/blog/post/2020/09/10/data-use-checkup-rolling-out-broadly-facebook-platform-developers/"},{"what":"Full Access eligibility (500+ calls in the past 15 days, under 15% errors)","every":"rolling 15 days","every_days":15,"source_url":"https://developers.facebook.com/docs/marketing-api/overview/authorization"}],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/meta/marketing-api"}