---
title: "Update Message Settings"
method: PUT
path: "/settings/messages"
tags: ["Settings"]
---

# Update Message Settings

`PUT /settings/messages`

Update message settings for the customer.

All users can update notification settings.
Only admin users can update messages_enabled (ignored for non-admin users).

## Request body

- UpdateMessageSettingsRequest — Update message settings request model
  - `messages_enabled` boolean, nullable — Whether message taking is enabled (admin only, ignored for non-admin users)
  - `sms_notifications_enabled` boolean, required — Whether SMS notifications are enabled
  - `sms_recipients` string[] — List of phone numbers (E.164 format) to receive SMS notifications
  - `email_notifications_enabled` boolean, required — Whether email notifications are enabled
  - `email_recipients` string[] — List of email addresses to receive notifications

## Response `200`

Successful Response

- MessageSettingsResponse — Message settings response model
  - `messages_enabled` boolean, required — Whether message taking is enabled for this customer
  - `sms_notifications_enabled` boolean, required — Whether SMS notifications are enabled
  - `sms_recipients` string[] — List of phone numbers (E.164 format) to receive SMS notifications
  - `email_notifications_enabled` boolean, required — Whether email notifications are enabled
  - `email_recipients` string[] — List of email addresses to receive notifications

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)