# Rechte

> Jedes Recht eines Schlüssels, welche Stufe es enthält, welche ein eigenes Kästchen haben und welche Aufrufe es nutzen.

Stand: 2026-10-30. Quelle: https://docs.smartchat.marketing/de/api/permissions/

Ein Schlüssel hat eine Menge von Rechten. Du wählst beim Anlegen eine Stufe und kannst einzelne Rechte anhaken. Ein Aufruf mit fehlendem Recht scheitert mit [`insufficient_scope`](https://docs.smartchat.marketing/de/errors/#insufficient_scope).

| Level | What it means | Permissions |
|---|---|---|
| Read | Read everything that is not secret. Changes nothing, with one exception: it can request a contact export, which creates a file with personal data. | 17 |
| Draft | Everything in Read, plus create and change drafts. Nothing reaches other people. | 25 |
| All | Everything except deleting and the plan. It includes the permissions with their own checkbox; in the app you can untick them. | 38 |

Rechte mit "ja" in der Spalte **Eigenes Kästchen** erreichen andere Menschen oder zeigen Geheimnisse. Die Stufe **All** enthält sie, aber in der App hat jedes von ihnen ein eigenes Kästchen, das du abhaken kannst. Die Stufen **Read** und **Draft** enthalten sie nie.

Es gibt keine Rechte zum Löschen. Siehe [was Schlüssel nie können](https://docs.smartchat.marketing/de/authentication/).

Recht und Wirkung sind zwei verschiedene Dinge. Ein Recht sagt, welche Aufrufe ein Schlüssel machen darf. Eine Wirkung sagt, was ein Aufruf tut. `create_contact_export` braucht das Recht `contacts:read`, weil es deine Kontakte liest. Trotzdem erzeugt es eine neue Datei mit Namen, Telefonnummern und E-Mail-Adressen. Darum markiert MCP das Werkzeug `export_contacts` als Schreib-Werkzeug (`readOnlyHint` ist `false`). Ein Schlüssel mit nur der Stufe **Read** kann also einen Export starten.

| Permission | What it allows | Read | Draft | All | Own checkbox | Used by |
|---|---|---|---|---|---|---|
| `contacts:read` | Read contacts, tags and contact export requests (phone numbers included). | yes | yes | yes | - | [get_optin_status](https://docs.smartchat.marketing/en/api/reference/account/get_optin_status/), [search_contacts](https://docs.smartchat.marketing/en/api/reference/contacts/search_contacts/), [get_contact](https://docs.smartchat.marketing/en/api/reference/contacts/get_contact/), [list_tags](https://docs.smartchat.marketing/en/api/reference/contacts/list_tags/), [create_contact_export](https://docs.smartchat.marketing/en/api/reference/contacts/create_contact_export/), [get_contact_export](https://docs.smartchat.marketing/en/api/reference/contacts/get_contact_export/) |
| `contacts:write` | Create and change contacts, add and remove tags. Never sets a contact to confirmed. | - | yes | yes | - | [create_contact](https://docs.smartchat.marketing/en/api/reference/contacts/create_contact/), [update_contact](https://docs.smartchat.marketing/en/api/reference/contacts/update_contact/), [tag_contacts](https://docs.smartchat.marketing/en/api/reference/contacts/tag_contacts/), [create_conversation_note](https://docs.smartchat.marketing/en/api/reference/conversations/create_conversation_note/) |
| `contacts:unsubscribe` | Unsubscribe a contact from all marketing messages. Cannot be undone through the API; MCP asks for a confirmation. | - | - | yes | - | [unsubscribe_contact](https://docs.smartchat.marketing/en/api/reference/contacts/unsubscribe_contact/) |
| `sends:read` | Read the delivery status of sends. | yes | yes | yes | - | [get_send](https://docs.smartchat.marketing/en/api/reference/sends/get_send/) |
| `sends:create` | Send a single message (free text or template) and send opt-in confirmations. | - | - | yes | - | [create_optin_confirmations](https://docs.smartchat.marketing/en/api/reference/contacts/create_optin_confirmations/), [send_text_message](https://docs.smartchat.marketing/en/api/reference/sends/send_text_message/), [send_template_message](https://docs.smartchat.marketing/en/api/reference/sends/send_template_message/) |
| `inbox:read` | Read conversations and messages. | yes | yes | yes | - | [list_conversations](https://docs.smartchat.marketing/en/api/reference/conversations/list_conversations/), [get_conversation](https://docs.smartchat.marketing/en/api/reference/conversations/get_conversation/), [list_messages](https://docs.smartchat.marketing/en/api/reference/conversations/list_messages/), [list_events](https://docs.smartchat.marketing/en/api/reference/meta/list_events/) |
| `inbox:write` | Assign, close, mark as read and hand over conversations; add internal notes. | - | yes | yes | - | [update_conversation](https://docs.smartchat.marketing/en/api/reference/conversations/update_conversation/), [create_conversation_note](https://docs.smartchat.marketing/en/api/reference/conversations/create_conversation_note/) |
| `templates:read` | Read message templates. | yes | yes | yes | - | [list_templates](https://docs.smartchat.marketing/en/api/reference/templates/list_templates/), [get_template](https://docs.smartchat.marketing/en/api/reference/templates/get_template/) |
| `templates:write` | Create and change template drafts. | - | yes | yes | - | [create_template](https://docs.smartchat.marketing/en/api/reference/templates/create_template/), [update_template](https://docs.smartchat.marketing/en/api/reference/templates/update_template/) |
| `templates:submit` | Submit templates to WhatsApp for approval. | - | - | yes | yes | [create_template_submissions](https://docs.smartchat.marketing/en/api/reference/templates/create_template_submissions/) |
| `newsletters:read` | Read newsletters, previews and progress. | yes | yes | yes | - | [list_newsletters](https://docs.smartchat.marketing/en/api/reference/newsletters/list_newsletters/), [get_newsletter](https://docs.smartchat.marketing/en/api/reference/newsletters/get_newsletter/), [get_newsletter_send_preview](https://docs.smartchat.marketing/en/api/reference/newsletters/get_newsletter_send_preview/) |
| `newsletters:write` | Create and change newsletter drafts and create send plans. | - | yes | yes | - | [create_newsletter](https://docs.smartchat.marketing/en/api/reference/newsletters/create_newsletter/), [update_newsletter](https://docs.smartchat.marketing/en/api/reference/newsletters/update_newsletter/) |
| `newsletters:send` | Send, schedule, pause, resume and cancel newsletters in one step. Needs an idempotency key. | - | - | yes | yes | [create_optin_confirmations](https://docs.smartchat.marketing/en/api/reference/contacts/create_optin_confirmations/), [send_newsletter](https://docs.smartchat.marketing/en/api/reference/newsletters/send_newsletter/), [control_newsletter](https://docs.smartchat.marketing/en/api/reference/newsletters/control_newsletter/) |
| `newsletters:test` | Send a test newsletter to any phone number (approved templates only, never to unsubscribed contacts). | - | - | yes | - | [send_test_newsletter](https://docs.smartchat.marketing/en/api/reference/newsletters/send_test_newsletter/) |
| `followups:read` | Read follow-up sequences. | yes | yes | yes | - | [list_followup_sequences](https://docs.smartchat.marketing/en/api/reference/followups/list_followup_sequences/), [get_followup_sequence](https://docs.smartchat.marketing/en/api/reference/followups/get_followup_sequence/) |
| `followups:write` | Change follow-up sequences and their steps. | - | yes | yes | - | [create_followup_sequence](https://docs.smartchat.marketing/en/api/reference/followups/create_followup_sequence/), [update_followup_sequence](https://docs.smartchat.marketing/en/api/reference/followups/update_followup_sequence/) |
| `automations:read` | Read automations and their runs. | yes | yes | yes | - | [get_automation_catalog](https://docs.smartchat.marketing/en/api/reference/automations/get_automation_catalog/), [list_automations](https://docs.smartchat.marketing/en/api/reference/automations/list_automations/), [get_automation](https://docs.smartchat.marketing/en/api/reference/automations/get_automation/), [list_automation_runs](https://docs.smartchat.marketing/en/api/reference/automations/list_automation_runs/) |
| `automations:write` | Create and change automations as drafts. Activating one or changing a running one also needs automations:run. | - | yes | yes | - | [create_automation](https://docs.smartchat.marketing/en/api/reference/automations/create_automation/), [update_automation](https://docs.smartchat.marketing/en/api/reference/automations/update_automation/), [set_automation_status](https://docs.smartchat.marketing/en/api/reference/automations/set_automation_status/) |
| `automations:run` | Start an automation with data (live run). | - | - | yes | - | [create_automation_run](https://docs.smartchat.marketing/en/api/reference/automations/create_automation_run/) |
| `hooks:read_secret` | Read the secret of an automation's inbound web address. | - | - | yes | yes | [get_inbound_webhook](https://docs.smartchat.marketing/en/api/reference/automations/get_inbound_webhook/) |
| `landing:read` | Read the landing page and its catalog. | yes | yes | yes | - | [get_landing_catalog](https://docs.smartchat.marketing/en/api/reference/landing/get_landing_catalog/), [get_landing_page](https://docs.smartchat.marketing/en/api/reference/landing/get_landing_page/) |
| `landing:write` | Apply edit operations to the landing page (does not publish). | - | yes | yes | - | [apply_landing_page_ops](https://docs.smartchat.marketing/en/api/reference/landing/apply_landing_page_ops/), [restore_landing_page](https://docs.smartchat.marketing/en/api/reference/landing/restore_landing_page/) |
| `landing:publish` | Publish a draft of the landing page. The live page is never taken offline; the previous version can be restored. | - | - | yes | yes | [publish_landing_page](https://docs.smartchat.marketing/en/api/reference/landing/publish_landing_page/) |
| `ai:settings_read` | Read the SmartChat AI reply settings and the learned answers. | yes | yes | yes | - | [get_ai_reply_settings](https://docs.smartchat.marketing/en/api/reference/ai_reply/get_ai_reply_settings/), [list_learned_answers](https://docs.smartchat.marketing/en/api/reference/ai_reply/list_learned_answers/) |
| `ai:settings` | Change the SmartChat AI reply settings and learned answers. Turning the AI reply on lets SmartChat answer your customers on its own, so this right is only in the level "all". | - | - | yes | - | [update_ai_reply_settings](https://docs.smartchat.marketing/en/api/reference/ai_reply/update_ai_reply_settings/), [create_learned_answer](https://docs.smartchat.marketing/en/api/reference/ai_reply/create_learned_answer/), [update_learned_answer](https://docs.smartchat.marketing/en/api/reference/ai_reply/update_learned_answer/) |
| `knowledge:read` | Search the knowledge and list knowledge documents. | yes | yes | yes | - | [search_knowledge](https://docs.smartchat.marketing/en/api/reference/knowledge/search_knowledge/), [list_knowledge_documents](https://docs.smartchat.marketing/en/api/reference/knowledge/list_knowledge_documents/) |
| `knowledge:write` | Upload knowledge documents (analysis with a model stays in the app). | - | - | yes | - | - |
| `media:read` | Read the media library. | yes | yes | yes | - | [list_media](https://docs.smartchat.marketing/en/api/reference/media/list_media/) |
| `media:write` | Upload media files. | - | yes | yes | - | [create_media](https://docs.smartchat.marketing/en/api/reference/media/create_media/) |
| `settings:read` | Read the business profile, brand, content rules and follow-up timing. | yes | yes | yes | - | [get_business_profile](https://docs.smartchat.marketing/en/api/reference/business_profile/get_business_profile/), [get_followup_settings](https://docs.smartchat.marketing/en/api/reference/followups/get_followup_settings/) |
| `settings:write` | Change the business profile, brand, content rules, template style, test number and follow-up timing. Never legal texts, tracking or connections. Only in the level "all". | - | - | yes | - | [update_business_profile](https://docs.smartchat.marketing/en/api/reference/business_profile/update_business_profile/), [update_followup_settings](https://docs.smartchat.marketing/en/api/reference/followups/update_followup_settings/) |
| `webhooks:read` | Read outgoing webhook endpoints and deliveries. | yes | yes | yes | - | [list_webhook_endpoints](https://docs.smartchat.marketing/en/api/reference/webhooks/list_webhook_endpoints/), [get_webhook_endpoint](https://docs.smartchat.marketing/en/api/reference/webhooks/get_webhook_endpoint/), [list_webhook_deliveries](https://docs.smartchat.marketing/en/api/reference/webhooks/list_webhook_deliveries/) |
| `webhooks:write` | Create, change and unsubscribe outgoing webhook endpoints. | - | - | yes | - | [create_webhook_endpoint](https://docs.smartchat.marketing/en/api/reference/webhooks/create_webhook_endpoint/), [update_webhook_endpoint](https://docs.smartchat.marketing/en/api/reference/webhooks/update_webhook_endpoint/), [unsubscribe_webhook_endpoint](https://docs.smartchat.marketing/en/api/reference/webhooks/unsubscribe_webhook_endpoint/), [rotate_webhook_secret](https://docs.smartchat.marketing/en/api/reference/webhooks/rotate_webhook_secret/), [enable_webhook_endpoint](https://docs.smartchat.marketing/en/api/reference/webhooks/enable_webhook_endpoint/), [test_webhook_endpoint](https://docs.smartchat.marketing/en/api/reference/webhooks/test_webhook_endpoint/), [replay_webhook_events](https://docs.smartchat.marketing/en/api/reference/webhooks/replay_webhook_events/), [redeliver_webhook_delivery](https://docs.smartchat.marketing/en/api/reference/webhooks/redeliver_webhook_delivery/) |
| `connections:read` | Read connected apps (status only) and the names of vault secrets, never their values. | yes | yes | yes | - | - |
| `connections:run` | Run actions of connected apps. Actions that delete data in the app stay blocked. | - | - | yes | yes | - |
| `stats:read` | Read statistics without personal data. | yes | yes | yes | - | [get_stats](https://docs.smartchat.marketing/en/api/reference/stats/get_stats/) |
| `team:read` | Read team members (name and role). | yes | yes | yes | - | [list_team_members](https://docs.smartchat.marketing/en/api/reference/team/list_team_members/) |
| `account:read` | Read the account overview (setup, credit balance). | yes | yes | yes | - | [get_account_overview](https://docs.smartchat.marketing/en/api/reference/account/get_account_overview/) |
| `billing:read` | Read plan, invoices and credit history. | - | - | - | - | [get_billing](https://docs.smartchat.marketing/en/api/reference/billing/get_billing/), [list_invoices](https://docs.smartchat.marketing/en/api/reference/billing/list_invoices/), [list_credit_history](https://docs.smartchat.marketing/en/api/reference/billing/list_credit_history/) |