---
title: "Update the Max email settings for a mailbox"
method: PUT
path: "/public/v1/max/settings/email/{connectedAccountId}"
tags: ["Max Settings"]
---

# Update the Max email settings for a mailbox

`PUT /public/v1/max/settings/email/{connectedAccountId}`

Updates one connected mailbox's email behaviour — auto-drafting, labels, signature, and contact auto-creation. Settings are per mailbox, so a user with several mailboxes configures each one separately. Switching `categorizationEnabled`, `draftEnabled` or `followupEnabled` on requires the `MAX_EMAIL_AGENT` license on the user's seat; switching them off always works. Requires a USER API key.

## Path parameters

- `connectedAccountId` string, required

## Request body

- object
  - `categorizationEnabled` boolean
  - `categorizationInstructions` string, nullable
  - `toRespondSensitivity` 'LEVEL_1' | 'LEVEL_2' | 'LEVEL_3' | 'LEVEL_4'
  - `marketingSensitivity` 'LEVEL_1' | 'LEVEL_2' | 'LEVEL_3' | 'LEVEL_4'
  - `labels` object[]
    - `id` number, nullable
    - `isActive` boolean, required
    - `moveToFolder` boolean, required
    - `color` 'SALMON' | 'APRICOT' | 'VANILLA' | 'TEAL' | 'MINT' | 'SKY' | 'LAVENDER' | 'ROSE' | 'GRAY' | 'RED' | 'ORANGE' | 'YELLOW' | 'GREEN' | 'EMERALD' | 'TURQUOISE' | 'BLUE' | 'COBALT' | 'VIOLET' | 'PURPLE' | 'PINK' | 'CORAL' | 'BROWN' | 'CHOCOLATE' | 'BLACK' | 'WHITE' | 'LIGHTGRAY' | 'DARKGRAY' | 'DANGER' | 'WARNING' | 'SUCCESS' | 'INFO' | 'NEUTRAL', required
    - `generateAutoDraft` boolean, required
    - `name` string, required
    - `description` string, required
    - `ingestEmail` boolean, required
  - `draftEnabled` boolean
  - `draftInstructions` string, nullable
  - `customSignature` string, nullable
  - `followupEnabled` boolean
  - `followUpInstructions` string, nullable
  - `followUpAfter` integer
  - `emailProcessingEnabled` boolean
  - `contactSyncEnabled` boolean
  - `autoCreateContactsModeOverride` 'ALL_CONTACTS' | 'SELECTIVE' | 'NONE', nullable
  - `linkMaxContactToPeopleOverride` boolean, nullable
  - `peopleSyncDefaultOverride` boolean, nullable
  - `peopleSyncRecordTypeId` integer, nullable

## Response `200`

Updated email settings

- object
  - `ok` true, required
  - `data` object, required
    - `connectedAccountId` number, required
    - `connectedEmail` string, nullable, required
    - `toolkit` string, required
    - `emailAgentEnabled` boolean, required
    - `customLabelsLimit` number, required
    - `categorizationEnabled` boolean, required
    - `categorizationInstructions` string, nullable, required
    - `toRespondSensitivity` 'LEVEL_1' | 'LEVEL_2' | 'LEVEL_3' | 'LEVEL_4', required
    - `marketingSensitivity` 'LEVEL_1' | 'LEVEL_2' | 'LEVEL_3' | 'LEVEL_4', required
    - `labels` object[], required
      - `id` number, required
      - `name` string, required
      - `color` string, required
      - `guidelines` string, nullable, required
      - `ingestEmail` boolean, required
      - `generateAutoDraft` boolean, required
      - `description` string, nullable, required
      - `moveToFolder` boolean, required
      - `isActive` boolean, required
      - `type` 'SYSTEM' | 'CUSTOM', required
      - `createdAt` string, required
      - `updatedAt` string, required
    - `draftEnabled` boolean, required
    - `draftInstructions` string, nullable, required
    - `customSignature` string, nullable, required
    - `writingStyle` string, nullable, required
    - `followupEnabled` boolean, required
    - `followUpInstructions` string, nullable, required
    - `followUpAfter` number, required
    - `emailProcessingEnabled` boolean, required
    - `contactSyncEnabled` boolean, required
    - `autoCreateContactsModeOverride` 'ALL_CONTACTS' | 'SELECTIVE' | 'NONE', nullable, required
    - `linkMaxContactToPeopleOverride` boolean, nullable, required
    - `peopleSyncDefaultOverride` boolean, nullable, required
    - `peopleSyncRecordTypeId` integer, nullable, required
    - `effectiveAutoCreateContactsMode` 'ALL_CONTACTS' | 'SELECTIVE' | 'NONE', required
    - `effectiveLinkMaxContactToPeople` boolean, required
    - `effectivePeopleSyncDefault` boolean, required
    - `effectivePeopleSyncRecordTypeId` integer, nullable, required
    - `accountDefaultRecordTypeId` integer, nullable, required
    - `canEditSettings` boolean, required

## Other responses

- `401` — Unauthorized — a USER API key is required
- `402` — Enabling labeling, drafting or follow-ups without the Email Agent add-on on this seat

## Changes

- **2026-10-03** `666cd9efa9f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getfrontline/apis/public-api/changes/public/v1/max/settings/email/:connectedAccountId/put.md)

---

[API](https://skmtc.dev/getfrontline/apis/public-api.md) · [All operations](https://skmtc.dev/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfrontline/apis/public-api/revisions/666cd9efa9f3?raw)