Delete a user
DELETE {{baseUrl}}/users/:userId?encrypted_email=false&action=disassociate&transfer_email=<string>&transfer_meeting=<boolean>&transfer_webinar=<boolean>&transfer_recording=<boolean>&transfer_whiteboard=<boolean>
Disassociate (unlink) a user or permanently delete a user.
Disassociating a user unlinks the user from the associated Zoom account and provides the user their own basic free Zoom account. The disassociated user can then purchase their own Zoom licenses. An account owner or account admin can transfer the user's meetings, webinars, and cloud recordings to another user before disassociation.
Deleting a user permanently removes the user and their data from Zoom. Users can create a new Zoom account using the same email address. An account owner or an account admin can transfer meetings, webinars, and cloud recordings to another Zoom user account before deleting.
For user-level apps, pass
the
me
value
instead of the
userId
parameter.
Note: This API does not support the deletion requirements of a Data Subject Access Request (DSAR) . For a DSAR request, contact Zoom Support.
Scopes:
user:write:admin
,
user:write
Rate Limit Label
:
LIGHT
Request Params
| Key | Datatype | Required | Description |
| encrypted_email
| boolean | | Whether the email address passed for the userId
value is an encrypted email address.
true
- The email address is encrypted.false
- The email address is not encrypted.
If you do not query this parameter, this value defaults to null (false
). |
| action
| string | | Delete action options.
disassociate
- Disassociate a user.
delete
- Permanently delete a user.
Note: To delete pending user in the account, use disassociate
|
| transfer_email
| string | | Transfer email. This field is required if the user has Zoom Events/Sessions feature. After you delete or disassociate the user, the user's hub assets on Zoom Events site will be transferred to the target user. |
| transfer_meeting
| string | | Transfer meeting. |
| transfer_webinar
| string | | Transfer webinar. |
| transfer_recording
| string | | Transfer recording. |
| transfer_whiteboard
| string | | When deleting a user, whether to transfer all their Zoom Whiteboard data to another user. |
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status: ``