Skip to content
Last updated

Max Proactive

Max Proactive controls whether Max reaches out unprompted — on which channel, how often, within which hours, and for which events.

These settings govern when Max may act on its own, so they are read-only on the Public API. The user changes them in the app. Requires a USER API key.

Today Max reacts to completed meetings that left action items (MEETING_COMPLETED_WITH_ACTION_ITEMS). Pre-meeting reminders are a separate feature under Max Meetings settings.

Identity

FieldTypeNotes
enabledbooleanMaster toggle.
preferredChannelenumAUTO · WHATSAPP · SLACK.
frequencyenumRELAXED · BALANCED · ACTIVE.
deliveryWindowStartnumberHour of day (0–23) Max may write from.
deliveryWindowEndnumberHour of day (0–23) Max may write until.
allowWeekendsbooleanWhether Saturday/Sunday are in scope.
enabledEventTypesarrayCurrently MEETING_COMPLETED_WITH_ACTION_ITEMS.
proactiveInstructionsstringFree-form guidance on what is worth a nudge (max 2000 chars).
lastProactiveContactAtstring?When Max last reached out.

A 404 means the caller's Max profile has no proactive settings row yet (typically a user who has never opened the setting in the app).

Operations

VerbPathPurpose
GET/public/v1/max/settings/proactiveRead proactive settings

Full details in the API Reference under the Max Proactive tag.

CLI

max settings proactive get --pretty