Logo
Zoom Public API Documentation

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

 

Body PARAM

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](https://support.zoom.us/hc/en-us/articles/4410916881421) data to another user.



HEADERS

Key Datatype Required Description 




RESPONSES

status





Curl
curl -X DELETE 'https://api.zoom.us/v2/users/:userId?encrypted_email=false&action=disassociate&transfer_email=<string>&transfer_meeting=<boolean>&transfer_webinar=<boolean>&transfer_recording=<boolean>&transfer_whiteboard=<boolean>?encrypted_email=false&action=disassociate&transfer_email=<string>&transfer_meeting=<boolean>&transfer_webinar=<boolean>&transfer_recording=<boolean>&transfer_whiteboard=<boolean>'

ENDPOINTS