---
title: "Get the Max proactive settings"
method: GET
path: "/public/v1/max/settings/proactive"
tags: ["Max Proactive"]
---

# Get the Max proactive settings

`GET /public/v1/max/settings/proactive`

Returns whether Max may reach out unprompted, and under what conditions: the channel it uses, how often it may interrupt, the hours it is allowed to write in, whether weekends are fair game, which events it reacts to, and free-form instructions on what is worth a nudge. Read-only — these settings govern when Max may act on its own, so they are changed in the app by the user themselves and cannot be written through the API. Requires a USER API key.

## Response `200`

Proactive settings

- object
  - `ok` true, required
  - `data` object, required
    - `enabled` boolean, required
    - `preferredChannel` 'AUTO' | 'WHATSAPP' | 'SLACK', required
    - `frequency` 'RELAXED' | 'BALANCED' | 'ACTIVE', required
    - `deliveryWindowStart` number, required
    - `deliveryWindowEnd` number, required
    - `allowWeekends` boolean, required
    - `enabledEventTypes` string[], required
    - `proactiveInstructions` string, required
    - `lastProactiveContactAt` string, nullable, required

## Other responses

- `401` — Unauthorized — a USER API key is required
- `404` — The caller's Max profile has no proactive settings row

## Changes

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

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