Add a user's shared access setting

POST {{baseUrl}}/phone/users/:userId/settings/:settingType

Adds the user setting according to the setting type, specifically for delegation, intercom and shared access for voicemail, and call recordings. For user-level apps, pass the me value instead of the userId parameter.

To see the shared access settings in the Zoom web portal, go to Admin > Phone System Management > Users & Rooms . Click Users and select User Policy . Go to Voicemail, Automatic Call Recording and Ad Hoc Call Recording .

To view the delegation and intercom setting in your Zoom web portal, navigate to Admin > Phone System Management > Users & Rooms . Click the Users tab and select User Settings

Prerequisites:

  • A Business or Enterprise account

Scopes: phone:write:admin , phone:write

Granular Scopes: phone:write:shared_setting , phone:write:shared_setting:admin

Rate Limit Label : Light

Request Body

{"delegation_assistant_extension_id"=>"<string>", "device_id"=>"<string>", "voice_mail"=>{"access_user_id"=>"<string>", "delete"=>"<boolean>", "download"=>"<boolean>"}, "voicemail_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "allow_sharing"=>"<boolean>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>", "allow_sharing"=>"<boolean>"}], "auto_call_recording_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}], "ad_hoc_call_recording_access_members"=>[{"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}, {"access_user_id"=>"<string>", "allow_delete"=>"<boolean>", "allow_download"=>"<boolean>"}]}

HEADERS

| Key | Datatype | Required | Description | | Content-Type | string | | | | Accept | string | | |

RESPONSES

status: Created

{"delegation":{"assistants":[{"display_name":"\u003cstring\u003e","extension_id":"\u003cstring\u003e","extension_number":"\u003clong\u003e","extension_type":"\u003cstring\u003e","id":"\u003cstring\u003e"},{"display_name":"\u003cstring\u003e","extension_id":"\u003cstring\u003e","extension_number":"\u003clong\u003e","extension_type":"\u003cstring\u003e","id":"\u003cstring\u003e"}],"privacy":"\u003cboolean\u003e","privileges":2},"voice_mail":{"access_user_id":"\u003cstring\u003e","delete":"\u003cboolean\u003e","download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},"voicemail_access_members":[{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","allow_sharing":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","allow_sharing":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"}],"auto_call_recording_access_members":[{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"}],"ad_hoc_call_recording_access_members":[{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"},{"access_user_id":"\u003cstring\u003e","allow_delete":"\u003cboolean\u003e","allow_download":"\u003cboolean\u003e","shared_id":"\u003cstring\u003e"}]}