Permissions (scopes)
Every API key and every AI app connection carries permissions. A request without the needed permission gets 403. Give each key only what it needs.
| Scope | Description | Available for API keys | Available for AI apps (MCP) |
|---|---|---|---|
contacts:read | Read contacts | yes | yes |
contacts:write | Create and change contacts | yes | yes |
contacts:delete | Delete contacts | yes | yes |
messages:write | Send WhatsApp messages and approved templates to opted-in contacts | yes | yes |
automations:read | See automations | yes | yes |
automations:write | Run automations | yes | yes |
automations:delete | Delete automations | yes | yes |
templates:read | See message templates | yes | yes |
templates:write | Create WhatsApp template drafts | yes | yes |
templates:submit | Submit templates to WhatsApp for approval | yes | yes |
templates:delete | Delete templates | yes | yes |
newsletters:read | See newsletters | yes | yes |
newsletters:write | Create and change newsletters | yes | yes |
newsletters:schedule | Schedule newsletters | yes | yes |
newsletters:delete | Delete newsletters | yes | yes |
followups:read | See follow-ups | yes | yes |
followups:write | Create and change follow-ups | yes | yes |
settings:read | Read business profile | yes | yes |
settings:write | Change business settings | yes | yes |
inbox:read | Read inbox conversations | yes | yes |
webhooks:read | yes | no | |
webhooks:write | yes | no | |
team:read | See team members | yes | yes |
stats:read | See statistics | yes | yes |
media:read | See media library | yes | yes |
ai:chat | Give tasks to SmartChat AI (newsletters, follow-ups, automations, landing page) | yes | yes |
landing:read | See landing page and popup | yes | yes |
landing:write | Change and publish landing page and popup | yes | yes |
media:write | Upload images, videos and files | yes | yes |
media:delete | Delete media | yes | yes |
inbox:write | Reply in the inbox and mark as read | yes | yes |
ai:settings | Change AI replies, style and learned answers | yes | yes |
knowledge:write | Upload and delete knowledge documents | yes | yes |
account:read | See plan, credits, invoices, domains and notifications | yes | yes |
account:write | Change team, domains, notifications, email senders and website widget | yes | yes |
Questions?
Email us at support@smartchat.marketing