---
title: "Set email preferences"
method: PATCH
path: "/v1/email-preferences"
tags: ["Account"]
---

# Set email preferences

`PATCH /v1/email-preferences`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/email-preferences`
- Auth: `bearerAuth` (a scheme the document does not define)

Set how often the attention summary may arrive and whether optional product emails may send. Send at least one field. `daily` sends at most once a day and only on days something is actually wrong; `weekly` gathers anything still unresolved into at most one email a week; `off` stops it entirely. `onboarding` controls optional product emails. There is deliberately no MCP tool for this: these emails are how a person learns a post did not go out, and an agent that could switch them off could hide a failure it caused.

## Request body

- object
  - `digestFrequency` 'off' | 'weekly' | 'daily'
  - `onboarding` boolean: Whether to receive optional product emails.

## Response `200`

Updated preferences

- EmailPreferences
  - `digest` boolean, required: False when digestFrequency is off. Kept so older clients still work.
  - `digestFrequency` 'off' | 'weekly' | 'daily', required
  - `onboarding` boolean, required: Whether optional product emails may send.

## Other responses

- `400` (unresolved $ref)
- `401`: Unauthorized

---

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