Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
User Settings

Update Notification Settings

Updates notification settings for the current extension. Knowledge Article: User Settings - Set Up Message Notifications

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

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

Request body

emailAddressesstring[]

List of notification recipient email addresses. Should not be empty if 'includeManagers' parameter is set to false

smsEmailAddressesstring[]

List of notification recipient email addresses

advancedModeboolean

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

includeManagersboolean

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

Updated notification settings

uristring uri

Canonical URI of notifications settings resource

emailAddressesstring[]

List of notification recipient email addresses

includeManagersboolean

Specifies if managers' emails are included in the list of emails to which notifications are sent

smsEmailAddressesstring[]

List of notification recipient email addresses

advancedModeboolean

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