---
title: "Set an account permission"
method: PUT
path: "/connectors/permissions/{tool}/accounts/{accountId}"
tags: ["Connectors"]
---

# Set an account permission

`PUT /connectors/permissions/{tool}/accounts/{accountId}`

## Request

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

Required permission: connectors:manage. One account's own permission for send_email, create_event or save_to_drive.

## Path parameters

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

## Request body

- SetAccountPermission
  - `mode` 'ask' | 'allow' | 'off' | 'default', required: As for the app's permission; `default` uses the app's.

## 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)