---
title: "Update Notification Settings"
method: PUT
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/notification-settings"
tags: ["User Settings"]
---

# Update Notification Settings

`PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}/notification-settings`

Updates notification settings for the current extension.
Knowledge Article: [User Settings - Set Up Message Notifications](https://success.ringcentral.com/articles/RC_Knowledge_Article/9740)

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Request body

- NotificationSettingsUpdateRequest
  - `emailAddresses` string[] — List of notification recipient email addresses. Should not be empty if 'includeManagers' parameter is set to false
  - `smsEmailAddresses` string[] — List of notification recipient email addresses
  - `advancedMode` boolean — Specifies notifications settings mode. If `true` then advanced mode is on, it allows using different emails and/or phone numbers for each notification type. If `false` then basic mode is on. Advanced mode settings are returned in both modes, if specified once, but if basic mode is switched on, they are not applied
  - `voicemails` VoicemailsInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for voicemail notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for voicemail notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `includeAttachment` boolean — Indicates whether voicemail should be attached to email
    - `includeTranscription` boolean — Specifies whether to add voicemail transcription or not
    - `markAsRead` boolean — Indicates whether a voicemail should be automatically marked as read
  - `inboundFaxes` InboundFaxesInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for inbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for inbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `includeAttachment` boolean — Indicates whether fax should be attached to email
    - `markAsRead` boolean — Indicates whether email should be automatically marked as read
  - `outboundFaxes` OutboundFaxesInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for outbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for outbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
  - `inboundTexts` InboundTextsInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for inbound text message notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for inbound text message notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
  - `missedCalls` MissedCallsInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for missed call notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for missed call notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
  - `includeManagers` boolean — Specifies if managers' emails are included in the list of emails to which notifications are sent. If not specified, then the value is `true`

## Response `200`

Updated notification settings

- NotificationSettings
  - `uri` string, uri — Canonical URI of notifications settings resource
  - `emailRecipients` EmailRecipientInfo[] — List of extensions specified as email notification recipients. Returned only for call queues where queue managers are assigned as user extensions.
    - `extensionId` string — Internal identifier of an extension
    - `fullName` string — User full name
    - `extensionNumber` string — User extension number
    - `status` 'Enabled' | 'Disable' | 'NotActivated' | 'Unassigned' — Current state of an extension
    - `emailAddresses` string[] — List of user email addresses from extension notification settings. By default, main email address from contact information is returned
    - `permission` 'FullAccess' | 'Messages' | 'MemberManagement' — Call queue manager permission
  - `emailAddresses` string[] — List of notification recipient email addresses
  - `includeManagers` boolean — Specifies if managers' emails are included in the list of emails to which notifications are sent
  - `smsEmailAddresses` string[] — List of notification recipient email addresses
  - `advancedMode` boolean — Specifies notifications settings mode. If `true` then advanced mode is on, it allows using different emails and/or phone numbers for each notification type. If `false` then basic mode is on. Advanced mode settings are returned in both modes, if specified once, but if basic mode is switched on, they are not applied
  - `voicemails` VoicemailsInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for voicemail notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for voicemail notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `includeAttachment` boolean — Indicates whether voicemail should be attached to email
    - `includeTranscription` boolean — Specifies whether to add voicemail transcription or not
    - `markAsRead` boolean — Indicates whether a voicemail should be automatically marked as read
  - `inboundFaxes` InboundFaxesInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for inbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for inbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `includeAttachment` boolean — Indicates whether fax should be attached to email
    - `markAsRead` boolean — Indicates whether email should be automatically marked as read
  - `outboundFaxes` OutboundFaxesInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for outbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for outbound fax notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
  - `inboundTexts` InboundTextsInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for inbound text message notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for inbound text message notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
  - `missedCalls` MissedCallsInfo
    - `notifyByEmail` boolean — Email notification flag
    - `notifyBySms` boolean — SMS notification flag
    - `advancedEmailAddresses` string[] — List of recipient email addresses for missed call notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only
    - `advancedSmsEmailAddresses` string[] — List of recipient phone numbers for missed call notifications. Returned if specified, in both modes (advanced/basic). Applied in advanced mode only

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)