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

# Get Notification Settings

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

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/notification-settings`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/notification-settings/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns 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

## Response `200`

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.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)