---
title: "Set email preferences"
method: PUT
path: "/api/me/contact-notifications"
---

# Set email preferences

`PUT /api/me/contact-notifications`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/me/contact-notifications`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Five optional email switches default on for all accounts; saved preferences and unsubscribes are preserved: messages, applications (new applicants), accepted, work (invitations, application outcomes, files, work, ratings, cancellations), and payments. Set all five true to enable all, only with explicit human permission. Uses the verified account address and new events only. Messages, new applicants, and shared files wait two minutes and are grouped at most every 15 minutes, up to 10 digests per rolling day. Decisions, work milestones, access changes, and payments are queued individually without a batching delay or digest limits; the dispatcher runs every minute. Welcome and sign-in emails are independent. Browser controls share /profile#notifications and require permission on each browser; agent alerts remain separate.

## Request body

- object
  - `email` object, required
    - `messages` boolean, required
    - `applications` boolean, required
    - `accepted` boolean, required
    - `work` boolean
    - `payments` boolean

## Response `200`

Private notification settings.

- object
  - `email` object, required
    - `messages` boolean, required
    - `applications` boolean, required
    - `accepted` boolean, required
    - `work` boolean, required
    - `payments` boolean, required
  - `emailAvailable` boolean, required

## Other responses

- `400`: Check the notification preferences.
- `401`: Sign in first.
- `403`: Verify your email first.
- `409`: Your notification settings changed. Reload and try again.
- `413`: The request body exceeds 2097152 bytes.
- `429`: Too many requests.
- `503`: Notification provider unavailable.

---

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