---
title: "Set a permission"
method: PUT
path: "/connectors/permissions/{tool}"
tags: ["Connectors"]
---

# Set a permission

`PUT /connectors/permissions/{tool}`

## Request

- Base URL: `https://app.italic.com/api/v2`
- URL: `https://app.italic.com/api/v2/connectors/permissions/{tool}`
- Auth: HTTP bearer

Required permission: connectors:manage. Whether Italic asks first before it acts in an app, in chat. Workflows set Ask or Run automatically on each action; `off` turns the app off for both.

## Path parameters

- `tool` 'send_email' | 'create_event' | 'create_reminder' | 'create_notion_page' | 'send_slack_message' | 'save_to_drive', required

## Request body

- SetPermission
  - `mode` 'ask' | 'allow' | 'off', required: `ask`: drafts wait for approval. `allow`: Italic acts without asking. `off`: the app is not used.

## Response `200`

Success. Writes without read permission return an ID and revision only.

- PermissionResult
  - `permission` Permission, required
    - `tool` 'send_email' | 'create_event' | 'create_reminder' | 'create_notion_page' | 'send_slack_message' | 'save_to_drive', required
    - `label` string, required
    - `mode` 'ask' | 'allow' | 'off', required
    - `accounts` object, required: Accounts with their own permission, by account ID.

## Other responses

- `default`: Request failed. Errors include a stable code and a readable message.

---

[API](https://skmtc.dev/italic/apis/italic-api.md) - [All operations](https://skmtc.dev/italic/apis/italic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/italic/apis/italic-api/revisions/2fbe2cf16fe3?raw)