Principle of Least Privilege — Only request scopes that are essential for your app’s core functionality. You can always request additional permissions later if needed.
Scope Description forms:readRead form configurations, fields, and settings forms:writeCreate and update forms forms:deleteDelete forms
Submissions Scope Description submissions:readRead form submissions and responses submissions:writeUpdate submission data submissions:deleteDelete form submissions
Scope Description contacts:readRead contacts and tags contacts:writeCreate, update, and manage contacts and tags contacts:deleteDelete contacts
Team Scope Description team:readRead team information team:writeUpdate team settings
Webhooks Scope Description webhooks:readRead webhook configurations webhooks:writeCreate and manage webhook subscriptions
Analytics Scope Description analytics:readRead form analytics and insights
Requesting Scopes Include the scopes you need in the authorization URL as a space-separated list:
scope=forms:read submissions:read webhooks:read webhooks:write
Common Scope Combinations Read-only Dashboard View forms and submissions without making changes
forms:read submissions:readCreate and manage form configurations
forms:read forms:writeFull Integration Complete access for building comprehensive integrations
forms:read forms:write submissions:read webhooks:read webhooks:writeNext Steps
OAuth Setup Implement the authorization flow
App Review Submit for marketplace listing
