1. Connect Meta
The user starts OAuth from the workspace, chooses Businesses, ad accounts, Pages, Instagram accounts, WhatsApp Business assets, catalogs, and lead sources, and can disconnect later from SPIRITT or Meta Business Integrations.
This page shows reviewers how a business owner connects Meta to SPIRITT, reviews business assets across ads, Pages, Instagram, WhatsApp, leads, catalogs, and messaging, asks the workspace agent for recommendations, and approves any risky action before it can publish, message, or change spend.
The user starts OAuth from the workspace, chooses Businesses, ad accounts, Pages, Instagram accounts, WhatsApp Business assets, catalogs, and lead sources, and can disconnect later from SPIRITT or Meta Business Integrations.
SPIRITT reads ad accounts, campaigns, creatives, catalogs, Pages, Instagram insights, WhatsApp setup, messages, and leads to summarize performance and account health.
Any action that can publish, message customers, spend, edit campaigns, or change business assets is saved as a draft until the user approves it.
Permission mapping
| Permission / feature | Why SPIRITT requests it | Demo surface |
|---|---|---|
| Marketing API Access Tier | Higher Marketing API limits for eligible business workflows after App Review approval. | Ads dashboard, campaign insights, creative inventory, and account health checks. |
| ads_read | Read ad accounts, campaigns, ad sets, ads, creatives, and insights. | Performance cards, spend summaries, campaign status, and reporting tables. |
| ads_management | Create and update campaigns, ad sets, ads, and creatives when the user approves. | Draft optimization suggestions with an approval gate before any publish or spend change. |
| business_management | Read business portfolios and connected business assets the user selected during OAuth. | Business selector, asset inventory, and system audit context. |
| pages_show_list / pages_read_engagement / pages_manage_ads | Find selected Pages, read Page metadata, and manage ads associated with Pages. | Page asset list and ad-account association checks. |
| catalog_management | Read and manage business-owned catalogs when the user grants access. | Catalog health module and product feed readiness checks. |
| instagram_basic / instagram_manage_insights / instagram_content_publish / instagram_manage_comments | Read Instagram business profile data, review insights, draft posts, publish approved content, and help moderate comments. | Instagram planner, insight cards, draft publishing queue, and comment moderation inbox. |
| pages_messaging / pages_manage_metadata / pages_read_user_content / pages_manage_posts | Read and manage Page messaging, Page metadata, Page content, and approved Page publishing workflows. | Unified inbox, Page content calendar, auto-drafted replies, and approval-gated post publishing. |
| whatsapp_business_management / whatsapp_business_messaging | Manage WhatsApp Business assets, templates, phone numbers, and send user-approved business messages. | WhatsApp business setup, template health, conversation assistant, and approved outbound message flow. |
| leads_retrieval | Retrieve lead form submissions from Pages and route them into the user's workspace workflows. | Lead inbox, qualification summary, CRM handoff, and audit log for retrieved lead data. |
| email / public_profile | Identify the connected reviewer or business user account. | Connected account card and permission confirmation screen. |
Approval gate
Draft recommendation
Increase daily budget, publish an Instagram post, or send a WhatsApp template
SPIRITT can prepare the action, but cannot publish, send, or spend until the user reviews the expected impact and clicks approve.
Audit log
Reviewer steps