---
title: "Get the account email settings"
method: GET
path: "/public/v1/settings/email"
tags: ["Data & Sync"]
---

# Get the account email settings

`GET /public/v1/settings/email`

Returns the account-wide email defaults every user inherits: whether contacts seen in mail are created automatically and under what conditions, whether those contacts are linked to People records, who the created record is assigned to, and whether administrators may view everyone's email activity. Read-only. A single write here changes behaviour for every user in the account at once — including data residency, retention and who may see whose activity — so these defaults are edited in the app by an administrator and there is no API or CLI write. `preferenceOverridePolicy` tells you whether they act as defaults each user may change in their own Max settings or as hard settings they cannot. Accepts an account API key, or a USER API key belonging to an OWNER or ADMIN.

## Response `200`

Account email settings

- object
  - `ok` true, required
  - `data` object, required
    - `autoCreateContactsMode` 'ALL_CONTACTS' | 'SELECTIVE' | 'NONE', required
    - `linkMaxContactToPeople` boolean, required
    - `peopleSyncDefault` boolean, required
    - `assignRecordToCreator` boolean, required
    - `peopleSyncRecordTypeId` number, nullable, required
    - `preferenceOverridePolicy` 'NONE' | 'ADMINS_AND_OWNERS' | 'ALL_USERS', required
    - `ignoreListOverridePolicy` 'NONE' | 'ADMINS_AND_OWNERS' | 'ALL_USERS', required
    - `adminViewAllActivity` boolean, required

## Other responses

- `401` — Unauthorized — the API key is missing or invalid
- `404` — The USER API key does not belong to an OWNER or ADMIN of the account

## Changes

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

[Change history](https://skmtc.dev/getfrontline/apis/public-api/changes/public/v1/settings/email/get.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)