{"openapi":"3.0.0","info":{"title":"Users","description":"The User APIs allow developers to programatically access data related to users, groups, and contact groups.","termsOfService":"https://zoom.us/docs/en-us/zoom_api_license_and_tou.html","contact":{"name":"Zoom Developers","url":"https://developer.zoom.us/"},"version":"2"},"externalDocs":{"description":"Find out more about Swagger","url":"https://swagger.io"},"servers":[{"url":"https://api.zoom.us/v2"}],"paths":{"/contacts/groups":{"get":{"tags":["Contact Groups"],"summary":"List contact groups","description":"List [contact groups](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under an account.\n\n**Prerequisite**: Pro or higher account. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:read:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`","operationId":"contactGroups","parameters":[{"name":"page_size","in":"query","description":"The number of records returned with a single API call. ","required":false,"schema":{"maximum":50,"type":"integer","example":10,"default":10}},{"name":"next_page_token","in":"query","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nList of contact groups returned.","content":{"application/json":{"schema":{"type":"object","properties":{"groups":{"type":"array","description":"List of contact group objects.","items":{"type":"object","properties":{"group_id":{"type":"string","description":"The group ID.","example":"dir.JquKVDGlQ9K6S0QVWGcysw"},"group_name":{"type":"string","description":"The group name.","example":"Developers"},"group_privacy":{"type":"integer","description":"The contact group privacy configuration: \n `1` - Visible to anyone, searchable by anyone. \n `2` - Visible to members only, searchable by anyone. \n `3` - Visible to members only, searchable by members only.","example":1,"enum":[1,2,3]},"description":{"type":"string","description":"The group description.","example":"A contact group for office A"}}}},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.\n","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":10}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request\n\n**Error Code:** `200`
\nOnly available for paid account: {accountId}\n\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:read:admin"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["contact_group:read:admin"]}},"post":{"tags":["Contact Groups"],"summary":"Create a contact group","description":"Use this API to create a [contact group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management).\n\n**Prerequisite**: Pro or higher account. \n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:write:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Heavy`","operationId":"contactGroupCreate","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"group_name":{"type":"string","description":"The contact group's name.","example":"Developers"},"group_privacy":{"type":"integer","description":"Contact group privacy configuration: \n `1` - Visible to anyone, searchable by anyone. \n `2` - Visible to members only, searchable by anyone. \n `3` - Visible to members only, searchable by members only.","example":1,"enum":[1,2,3]},"description":{"type":"string","description":"The group description.","example":"A contact group."},"group_members":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer","description":"Contact group member types: \n `1` - user. \n `2` - user group.","example":2,"enum":[1,2]},"id":{"type":"string","description":"The member ID: user ID (`user`) or user group ID (`user group`).","example":"n22T5G6bQDCugVm1V59TAQ"}},"description":"The contact group member information. The member type can be a `user` or `user group`. The maximum number members per request is 50 for the `user` and 3 for the `user group`."}}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \nGroup created.","content":{"application/json":{"schema":{"type":"object","properties":{"group_id":{"type":"string","description":"The contact group ID.","example":"A4ql1FjgL913r"},"group_name":{"type":"string","description":"The contact group's name.","example":"Developers"},"total_members":{"type":"integer","description":"The contact group's total member count.","example":34},"group_privacy":{"type":"integer","description":"Contact group privacy configuration: \n `1` - Visible to anyone, searchable by anyone. \n `2` - Visible to members only, searchable by anyone. \n `3` - Visible to members only, searchable by members only.","example":1,"enum":[1,2,3]},"description":{"type":"string","description":"The group description.","example":"A contact group."}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request\n\n**Error Code:** `200`
\nOnly available for paid account: {accountId}
\n\n**Error Code:** `300`
\nThe maximum number of user member per request is 50.
\n\n**Error Code:** `300`
\nThe maximum number of group member per request is 3.\n\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:write:admin"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["contact_group:write:admin"]}}},"/contacts/groups/{groupId}":{"get":{"tags":["Contact Groups"],"summary":"Get a contact group","description":"Get a [contact group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under an account.\n\n**Prerequisite**: Pro or higher account. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:write:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"contactGroup","parameters":[{"name":"groupId","in":"path","description":"The contact group ID. \n \nRetrieve by calling the [**List contact groups**](/docs/api-reference/zoom-api/methods#operation/contactGroups) API.","required":true,"schema":{"type":"string","example":"dir.JquKVDGlQ9K6S0QVWGcysw"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n Group returned.","content":{"application/json":{"schema":{"type":"object","properties":{"group_id":{"type":"string","description":"The group ID.","example":"dir.JquKVDGlQ9K6S0QVWGcysw"},"group_name":{"type":"string","description":"The group name.","example":"Developers"},"total_members":{"type":"integer","description":"The total number of members in a contact group.","example":10},"group_privacy":{"type":"integer","description":"The contact group privacy configuration: \n `1` - Visible to anyone, searchable by anyone. \n `2` - Visible to members only, searchable by anyone. \n `3` - Visible to members only, searchable by members only.","example":1,"enum":[1,2,3]},"description":{"type":"string","description":"The group description.","example":"A contact group for office A"}},"description":"The contact group information."}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request\n\n**Error Code:** `200`
\nOnly available for paid account: {accountId}
\n\n**Error Code:** `300`
\nA group with this groupId: {groupId} does not exist.\n\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:write:admin"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["contact_group:write:admin"]}},"delete":{"tags":["Contact Groups"],"summary":"Delete a contact group","description":"Use this API to delete a [contact group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-).\n\n**Prerequisite**: Pro or higher account. \n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:write:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Heavy`","operationId":"contactGroupDelete","parameters":[{"name":"groupId","in":"path","description":"The contact group ID. \n \nRetrieve by calling the [**List contact groups**](/docs/api-reference/zoom-api/methods#operation/contactGroups) API.","required":true,"schema":{"type":"string","example":"dir.JquKVDGlQ9K6S0QVWGcysw"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nGroup deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request\n\n**Error Code:** `200`
\nOnly available for paid account,{accountId}.
\n\n**Error Code:** `300`
\nA group with this groupId: {groupId} does not exist.\n\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:write:admin"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["contact_group:write:admin"]}},"patch":{"tags":["Contact Groups"],"summary":"Update a contact group","description":"Update a [contact group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under your account.\n\n**Prerequisite**: Pro or higher account. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:write:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Heavy`","operationId":"contactGroupUpdate","parameters":[{"name":"groupId","in":"path","description":"The contact group ID. \n \nRetrieve by calling the [**List contact groups**](/docs/api-reference/zoom-api/methods#operation/contactGroups) API.","required":true,"schema":{"type":"string","example":"dir.JquKVDGlQ9K6S0QVWGcysw"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The contact group's name.","example":"Developers"},"privacy":{"type":"integer","description":"Contact group privacy configuration: \n `1` - Visible to anyone, searchable by anyone. \n `2` - Visible to members only, searchable by anyone. \n `3` - Visible to members only, searchable by members only.","example":1,"enum":[1,2,3]},"description":{"type":"string","description":"The group description.","example":"A contact group."}}}}}},"responses":{"204":{"description":"Contact group updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request\n\n**Error Code:** `200`
\nOnly available for paid account: {accountId}
\n\n**Error Code:** `300`
\nA group with this groupId: {groupId} does not exist.\n\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:write:admin"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["contact_group:write:admin"]}}},"/contacts/groups/{groupId}/members":{"get":{"tags":["Contact Groups"],"summary":"List contact group members","description":"List members in [contact groups](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under an account.\n\n**Prerequisite**: Pro or higher account. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:read:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"contactGroupMembers","parameters":[{"name":"groupId","in":"path","description":"The group ID.","required":true,"schema":{"type":"string","example":"A4ql1FjgL913r"}},{"name":"page_size","in":"query","description":"The number of records returned with a single API call. ","required":false,"schema":{"maximum":50,"type":"integer","example":10,"default":10}},{"name":"next_page_token","in":"query","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nList of contact group members returned.","content":{"application/json":{"schema":{"type":"object","properties":{"group_members":{"type":"array","description":"List of contact group members.","items":{"type":"object","properties":{"type":{"type":"integer","description":"Contact group member types: \n `1` - user. \n `2` - user group.","example":2,"enum":[1,2]},"id":{"type":"string","description":"The member ID: user ID (`user`) or user group ID (`user group`).","example":"n22T5G6bQDCugVm1V59TAQ"},"name":{"type":"string","description":"The member's name: user's name (`user`) or the group's name (`user group`).","example":"Developer group"}},"description":"The contact group member information for `user` or `user group`."}},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.\n","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":10}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for paid account: {accountId}
\n**Error Code:** `300`
\n A group with this groupId: {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:read:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["contact_group:read:admin"]}},"post":{"tags":["Contact Groups"],"summary":"Add contact group members","description":"Use this API to add members to a [contact group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management).\n\n**Prerequisite**: Pro or higher account. \n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:write:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `HEAVY`","operationId":"contactGroupMemberAdd","parameters":[{"name":"groupId","in":"path","description":"The contact group ID.\nRetrieve by calling the List contact groups API.","required":true,"schema":{"type":"string","example":"dir.JquKVDGlQ9K6S0QVWGcysw"}}],"requestBody":{"description":"Add contact group members","content":{"application/json":{"schema":{"type":"object","properties":{"group_members":{"type":"array","description":"Group members array","items":{"type":"object","properties":{"type":{"type":"integer","description":"Contact group member types: \n `1` - user. \n `2` - user group.","example":2,"enum":[1,2]},"id":{"type":"string","description":"The member ID: user ID (`user`) or user group ID (`user group`).","example":"n22T5G6bQDCugVm1V59TAQ"}},"description":"The contact group member information. The member type can be a `user` or `user group`. The maximum number members per request is 50 for the `user` and 3 for the `user group`."}}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \nMember added.","content":{"application/json":{"schema":{"type":"object","properties":{"member_ids":{"type":"array","description":"Member ids array","items":{"type":"string","description":"The member ID of the member that is added successfully.","example":"KT6h5SfCSm6YNjZo7i8few"}}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for paid account: {accountId}
\n**Error Code:** `300`
\n A group with this groupId: {groupId} does not exist.
\n**Error Code:** `300`
\n The maximum number of user member per request is 50.
\n**Error Code:** `300`
\n The maximum number of group member per request is 3.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:write:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["contact_group:write:admin"]}},"delete":{"tags":["Contact Groups"],"summary":"Remove members in a contact group","description":"Removes members in a [contact group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-).\n\n**Prerequisite**: Pro or higher account. \n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `contact_group:write:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `HEAVY`","operationId":"contactGroupMemberRemove","parameters":[{"name":"groupId","in":"path","description":"The contact group ID.\nRetrieve by calling the List contact groups API.","required":true,"schema":{"type":"string","example":"dir.JquKVDGlQ9K6S0QVWGcysw"}},{"name":"member_ids","in":"query","description":"The member's ID in a contact group. Use commas (,) to separate a maximum of 20 ids. \n \nCan be retrieved by calling the [**List contact groups**](/docs/api-reference/zoom-api/methods#operation/contactGroupMembers) API.","required":true,"schema":{"type":"string","example":"n22T5G6bQDCugVm1V59TAQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nMember removed."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for paid account,{accountId}.
\n**Error Code:** `300`
\n A group with this groupId: {groupId} does not exist.
\n**Error Code:** `300`
\n The maximum number of memberId is 20.
\n**Error Code:** `300`
\n A member with this memberId: {memberId} does not exist.
\n**Error Code:** `300`
\n A group must have at least one member.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["contact_group:write:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["contact_group:write:admin"]}}},"/divisions":{"get":{"tags":["Divisions"],"summary":"List divisions","description":"List divisions under an account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** ` division:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:read:list_divisions:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`\n\n**Not supported in Gov cluster** ","operationId":"listDivisions","parameters":[{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through a large set of results. It returns whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nDivision list returned.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"Use the next page token to paginate through a large set of results. It returns whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30},"total_records":{"type":"integer","description":"The total records of divisions under the account.","example":300},"divisions":{"maxItems":300,"type":"array","description":"The information about the divisions.","items":{"type":"object","properties":{"division_id":{"type":"string","description":"The division's id","example":"example-TaOOmobxuqLVnw"},"division_name":{"type":"string","description":"The division's name.","example":"my division"},"division_description":{"type":"string","description":"The division's description.","example":"this is division"},"is_main_division":{"type":"boolean","description":"Is it Main Division","example":true},"total_members":{"type":"integer","description":"Total number of members in this division.","example":100}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request Invalid parameters. \n\n "},"401":{"description":"**HTTP Status Code:** `401`
\n Unauthorized \n\n **Error Code:** `30031002`
\n Missing token
\n**Error Code:** `30031004`
\n Invalid or expired token
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden No permission. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":[" division:read:admin","division:read:list_divisions:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Division:Read"],"x-macro-scopes":[" division:read:admin"],"x-granular-scopes":["division:read:list_divisions:admin"]}},"post":{"tags":["Divisions"],"summary":"Create a division","description":"Create a division. You can add a maximum of 500 divisions in one account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:wirte:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:write:division:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`\n\n**Not supported in Gov cluster** ","operationId":"Createadivision","requestBody":{"content":{"application/json":{"schema":{"required":["division_name"],"type":"object","properties":{"division_name":{"type":"string","description":"The division's name.","example":"my division"},"division_description":{"type":"string","description":"The division's description.","example":"this is division"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \nDivision created.","content":{"application/json":{"schema":{"type":"object","properties":{"division_id":{"type":"string","description":"The division's id","example":"example-TaOOmobxuqLVnw"},"division_name":{"type":"string","description":"The division's name.","example":"my division"},"division_description":{"type":"string","description":"The division's description.","example":"this is division"}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `40005`
\n Invalid field.
\n**Error Code:** `42006`
\n You've reached the maximum number of divisions reached. You can clean up some divisions then try again.
\n"},"401":{"description":"**HTTP Status Code:** `401`
\n Unauthorized \n\n **Error Code:** `30031004`
\n Invalid or expired token.
\n**Error Code:** `30031002`
\n Missing token.
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden No permission. \n\n "},"409":{"description":"**HTTP Status Code:** `409`
\n Conflict This name is already in use. Please try another. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["division:wirte:admin","division:write:division:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Division:Edit"],"x-macro-scopes":["division:wirte:admin"],"x-granular-scopes":["division:write:division:admin"]}}},"/divisions/{divisionId}":{"get":{"tags":["Divisions"],"summary":"Get a division","description":"Get a division under an account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:wirte:admin`,` division:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:read:division:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`\n\n**Not supported in Gov cluster** ","operationId":"Getdivision","parameters":[{"name":"divisionId","in":"path","description":"The division's id","required":true,"schema":{"type":"string","example":"sjdiefbasdas-emaple"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n Division returned. ","content":{"application/json":{"schema":{"type":"object","properties":{"division_id":{"type":"string","description":"The division's id","example":"example-TaOOmobxuqLVnw"},"division_name":{"type":"string","description":"The division's name.","example":"my division"},"division_description":{"type":"string","description":"The division's description.","example":"this is division"},"is_main_division":{"type":"boolean","description":"Is it Main Division","example":true}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request Invalid parameters. \n\n "},"401":{"description":"**HTTP Status Code:** `401`
\n Unauthorized \n\n **Error Code:** `30031002`
\n Missing token
\n**Error Code:** `30031004`
\n Invalid or expired token
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden No permission. \n\n "},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found Division not found. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["division:wirte:admin"," division:read:admin","division:read:division:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Division:Read"],"x-macro-scopes":["division:wirte:admin"," division:read:admin"],"x-granular-scopes":["division:read:division:admin"]}},"delete":{"tags":["Divisions"],"summary":"Delete a division","description":"Delete an entire division.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:wirte:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:delete:division:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`\n\n**Not supported in Gov cluster** ","operationId":"Deletedivision","parameters":[{"name":"divisionId","in":"path","description":"The division's ID.","required":true,"schema":{"type":"string","example":"jsjdfsaifh-example"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` Division deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `42011`
\n Main division can't be deleted.
\n**Error Code:** `42012`
\n Please remove all users from this division before deleting.
\n"},"401":{"description":"**HTTP Status Code:** `401`
\n Unauthorized \n\n **Error Code:** `30031002`
\n Missing token.
\n**Error Code:** `30031004`
\n Invalid or expired token.
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden No permission. \n\n "},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found Division not found. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["division:wirte:admin","division:delete:division:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Division:Edit"],"x-macro-scopes":["division:wirte:admin"],"x-granular-scopes":["division:delete:division:admin"]}},"patch":{"tags":["Divisions"],"summary":"Update a division","description":"Update a group under your account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:wirte:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:update:division:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`\n\n**Not supported in Gov cluster** ","operationId":"Updateadivision","parameters":[{"name":"divisionId","in":"path","description":"The division's ID.","required":true,"schema":{"type":"string","example":"sjdihshsifhh-example"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"division_name":{"type":"string","description":"The division's name.","example":"my division"},"division_description":{"type":"string","description":"The division's description.","example":"this is division"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` Division updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request Invalid parameters. \n\n "},"401":{"description":"**HTTP Status Code:** `401`
\n Unauthorized \n\n **Error Code:** `30031002`
\n Missing token
\n**Error Code:** `30031004`
\n Invalid or expired token
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden No permission. \n\n "},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found Division not found. \n\n "},"409":{"description":"**HTTP Status Code:** `409`
\n Conflict This name is already in use. Please try another. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["division:wirte:admin","division:update:division:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Division:Edit"],"x-macro-scopes":["division:wirte:admin"],"x-granular-scopes":["division:update:division:admin"]}}},"/divisions/{divisionId}/users":{"get":{"tags":["Divisions"],"summary":"List division members","description":"List the users of a division under your account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** ` division:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:read:member:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`\n\n**Not supported in Gov cluster** ","operationId":"listDivisionMembers","parameters":[{"name":"divisionId","in":"path","description":"The division's ID.","required":true,"schema":{"type":"string","example":"example-TaOOmobxuqLVnw"}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through a large set of results. It returns whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nDivision users returned.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"Use the next page token to paginate through a large set of results. It returns whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30},"total_records":{"type":"integer","description":"The total records of users under the division.","example":300},"users":{"maxItems":300,"type":"array","description":"List of a division's users.","items":{"type":"object","properties":{"user_id":{"type":"string","description":"The user's unique identifier.","example":"example-FLFD4pfkQ4a2nec"},"user_display_name":{"type":"string","description":"The user's display name.","example":"jill chill"},"user_email":{"type":"string","description":"The user's email address.","example":"jchill@example.com"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request Invalid parameters. \n\n "},"401":{"description":"**HTTP Status Code:** `401`
\n Unauthorized \n\n **Error Code:** `30031002`
\n Missing token.
\n**Error Code:** `30031004`
\n Invalid or expired token.
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden No permission. \n\n "},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found Division not found. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":[" division:read:admin","division:read:member:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Division:Read"],"x-macro-scopes":[" division:read:admin"],"x-granular-scopes":["division:read:member:admin"]}},"post":{"tags":["Divisions"],"summary":"Assign a division","description":"Assign a division to members. A user can belong to only one division.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:wirte:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `division:write:member:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`\n\n**Not supported in Gov cluster** ","operationId":"assigndivisionMember","parameters":[{"name":"divisionId","in":"path","description":"The division's ID.","required":true,"schema":{"type":"string","example":"example-sjdihshsifhhss"}}],"requestBody":{"description":"Division users","content":{"application/json":{"schema":{"type":"object","properties":{"users":{"maxItems":30,"type":"array","description":"Array of userId/user email of users to whom you would like to assign this division. Up to 30 users can be assigned a division at once.","items":{"type":"object","properties":{"user_email":{"type":"string","description":"Email address of the user to whom you would like to assign the division. Provide either the userId in the user_id field or the email address in the user_email field. If both fields are provided, only userId is used.","example":"user@example.com"},"user_id":{"type":"string","description":"User ID of the user to whom you would like to assign the division. ","example":"example_2RTm5TNvuvk4yRw"}}}}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` Division users added.","content":{"application/json":{"schema":{"type":"object","properties":{"added_at":{"type":"string","description":"Date and time at which the members are assigned to the division.","example":"2022-03-25T03:08:12Z"},"ids":{"type":"string","description":"User ids","example":"example-userId1,example-userId2"}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request Invalid parameters. \n\n "},"401":{"description":"**HTTP Status Code:** `401`
\n Unauthorized \n\n **Error Code:** `30031002`
\n Missing token.
\n**Error Code:** `30031004`
\n Invalid or expired token.
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden No permission. \n\n "},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `40406`
\n Division not found.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["division:wirte:admin","division:write:member:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Division:Edit"],"x-macro-scopes":["division:wirte:admin"],"x-granular-scopes":["division:write:member:admin"]}}},"/groups":{"get":{"tags":["Groups"],"summary":"List groups","description":"List [groups](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under an account.\n\n**Prerequisite**: Pro or higher account. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:list_groups:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groups","parameters":[{"name":"page_size","in":"query","description":"The number of records returned in a single API call. The maximum is 300.","required":false,"schema":{"maximum":300,"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"The next page token paginates through a set of large results. A next page token is returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nList of groups returned. \n \n**Error Code:** `200`\nOnly available for paid accounts.","content":{"application/json":{"schema":{"type":"object","properties":{"groups":{"maxItems":300,"type":"array","description":"List of Group objects.","items":{"allOf":[{"type":"object","properties":{"id":{"type":"string","description":"Group ID.","example":"SobVexyrQjqCkcxjpBWi6w"}}},{"type":"object","properties":{"name":{"type":"string","description":"Group name.","example":"Developers"},"total_members":{"type":"integer","description":"Total number of members in this group.","example":200}},"description":"Group object."}]}},"total_records":{"type":"integer","description":"Total records.","example":200},"next_page_token":{"type":"string","description":"The next page token paginates through a large set results. A next page token returns whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"qUEQqB1V0HVhJmwKFQrGOD"}},"description":"List of Groups."}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:list_groups:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:list_groups:admin"]}},"post":{"tags":["Groups"],"summary":"Create a group","description":"Use this API to create a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management). You can add a **maximum** of 100 groups in one account per day, and a maximum of 5000 groups in one account.\n\nIf you enabled a new group via the user interface, you can also choose whether to display the group and set its privacy level.\n\n**Prerequisites**: \n* A Pro or higher account\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:group:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"groupCreate","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The group's name.","example":"Developers"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \nGroup created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The group ID.","example":"A4ql1FjgL913r"},"name":{"type":"string","description":"The group's name.","example":"Developers"},"total_members":{"type":"integer","description":"The group's total member count.","example":34}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n Invalid parameter: name.
\n**Error Code:** `300`
\n Validation Failed.
\n**Error Code:** `300`
\n It has reached the maximum number of groups. You can clean up some groups then add.
\n**Error Code:** `200`
\n Only available for Paid account.
\n"},"409":{"description":"**HTTP Status Code:** `409`
\n Conflict \n\n **Error Code:** `4132`
\n The group name \"{groupName}\" is already in use.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:write:group:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:write:group:admin"]}}},"/groups/{groupId}":{"get":{"tags":["Groups"],"summary":"Get a group","description":"Get a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under an account.\n\n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:group:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"group","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n Group returned. \n \n**Error Code:** `200` \n \nOnly available for Paid account,{accountId}.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Group ID.","example":"825c9e31f1064c73b394c5e4557d3447"},"name":{"type":"string","description":"Group name.","example":"Developers"},"total_members":{"type":"integer","description":"Total count of members in the group.","example":100}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `1010`
\n Group does not belong to your account.
\n**Error Code:** `200`
\n Only available for Paid account.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:group:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:group:admin"]}},"delete":{"tags":["Groups"],"summary":"Delete a group","description":"Delete an entire [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-). **Prerequisites:** * A Pro, Business, or Education account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:delete:group:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"groupDelete","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}}],"responses":{"204":{"description":"Group deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account,{accountId}.
Group cannot be deleted. Information Barriers policies have been applied to this group.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n Group does not exist.
A group with this {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:delete:group:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:delete:group:admin"]}},"patch":{"tags":["Groups"],"summary":"Update a group","description":"Update a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under your account.\n\n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:update:group:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"groupUpdate","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Group name. It must be unique to one account and less than 128 characters.","example":"Developers"}}}}}},"responses":{"204":{"description":"Group updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n"},"409":{"description":"**HTTP Status Code:** `409`
\n Conflict \n\n **Error Code:** `4132`
\n Group name {groupName} is already in use.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:update:group:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:update:group:admin"]}}},"/groups/{groupId}/admins":{"get":{"tags":["Groups"],"summary":"List group admins","description":"Use this API to return a list of [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) administrators under your account.\n\n**Prerequisites:** \n* A Pro, Business, or Education account\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:administrator:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupAdmins","parameters":[{"name":"groupId","in":"path","description":"The group ID. Retrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n Only available for paid account: "{accountId}".","content":{"application/json":{"schema":{"type":"object","properties":{"admins":{"maxItems":300,"type":"array","items":{"type":"object","properties":{"email":{"type":"string","description":"The user's email address.","format":"email","example":"jchill@example.com"},"name":{"type":"string","description":"The user's display name.","example":"Jill Chill"}}}},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token is returned when the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"oMTCmjMRwzSfZtUXDIuWDswdksIQ3dyGUB1"},"page_size":{"type":"integer","description":"The number of records returned in a single API call.","example":1},"total_records":{"type":"integer","description":"The total number of records available across all pages.","example":20}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account.
\n**Error Code:** `300`
\n The next page token is invalid or expired.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with the \"{groupId}\" ID does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:administrator:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:administrator:admin"]}},"post":{"tags":["Groups"],"summary":"Add group admins","description":"Use this API to add administrators to a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under your account.\n\n**Prerequisites:** \n* A Pro, Business, or Education account\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:administrator:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupAdminsCreate","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"admins":{"maximum":10,"maxItems":10,"type":"array","description":"A list of the administrators to add to a group.","items":{"type":"object","properties":{"email":{"type":"string","description":"The user's email. Use this value if you do not have the user's ID.\n\nIf you pass the `id` value, the API ignores this parameter.","example":"jchill@example.com"},"id":{"type":"string","description":"The user's ID.","example":"v4iyWT1LTfy8QvPG4GTvdg"}}}}}}}}},"responses":{"201":{"description":"**Status Code:** `201` \n Group administrator added.","content":{"application/json":{"schema":{"type":"object","properties":{"added_at":{"type":"string","description":"The timestamp at which the administrator was added to the group.","format":"date-time","example":"2022-03-25T03:08:12Z"},"ids":{"type":"string","description":"The administrator IDs.","example":"v4iyWT1LTfy8QvPG4GTvdg"}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for paid account,{accountId}.
\n**Error Code:** `300`
\n Validation Failed.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with the \"{groupId}\" ID does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:write:administrator:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:write:administrator:admin"]}}},"/groups/{groupId}/admins/{userId}":{"delete":{"tags":["Groups"],"summary":"Delete a group admin","description":"Use this API to remove a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) administrator in a Zoom account.\n\n**Prerequisites:** \n* A Pro, Business, or Education account\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:delete:administrator:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"groupAdminsDelete","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}},{"name":"userId","in":"path","description":"The user ID or email address of the user. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string","example":"6dfgdfgdg444447b0egga"}}],"responses":{"204":{"description":"**Status Code:** `204` \n Group administrator removed."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `4138`
\n That user is not an administrator for the group: \"{groupId}\".
\n**Error Code:** `200`
\n Only available for Paid account.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with the \"{groupId}\" ID does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:delete:administrator:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:delete:administrator:admin"]}}},"/groups/{groupId}/channels":{"get":{"tags":["Groups"],"summary":"List group channels","description":"Returns a list of channels for a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under your account.\n\n**Prerequisite**: \n- Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:list_channels:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupChannels","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api/rest/reference/user/methods/#operation/groups) API.","required":true,"schema":{"type":"string","example":"A4ql1FjgL913r"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` List of group channels returned.","content":{"application/json":{"schema":{"required":["channels","group_id"],"type":"object","properties":{"channels":{"type":"array","description":"The channels in a group.","items":{"required":["channel_id","channel_name","member_count"],"type":"object","properties":{"channel_id":{"type":"string","description":"The unique identifier of the channel. ","example":"d26fd4dfebfa4aff9f31ee5710529442"},"channel_name":{"type":"string","description":"The name of the channel.","example":"Your Channel"},"member_count":{"type":"integer","description":"The member number of the channel.","example":10}}}},"group_id":{"type":"string","description":"The unique identifier of the group. ","example":"2NEr8QoCSZq4LV6s7jjYQA"}}}}}},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:list_channels:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:list_channels:admin"]}}},"/groups/{groupId}/lock_settings":{"get":{"tags":["Groups"],"summary":"Get locked settings","description":"Retrieve a [group's](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) locked settings. \nIf you lock a setting, the group members will not be able to modify it individually. \n\n **Note:** The `force_pmi_jbh_password` field under meeting settings is deprecated as of September 22, 2019. \n\n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:lock_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getGroupLockSettings","parameters":[{"name":"groupId","in":"path","description":"The group's ID.","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}},{"name":"option","in":"query","description":"Optional query parameters. \n* `meeting_security` - Use this query parameter to view the meeting security settings applied to the user's account.","required":false,"schema":{"type":"string","example":"meeting_security"}}],"responses":{"200":{"description":"**Status Code:** `200` \n \nLocked settings of group returned.\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"audio_conferencing":{"type":"object","properties":{"toll_free_and_fee_based_toll_call":{"type":"boolean","description":"Whether the group has the [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call) setting enabled.","example":true},"toll_call":{"type":"boolean","description":"Whether the group has the [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F51844DRCX3K7BRTMZ40381R) setting enabled.","example":true},"call_me_and_invite_by_phone":{"type":"boolean","description":"Whether the group has the [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VG7NCJDZ238VVXZDJ8QMH) setting enabled.","example":true},"personal_audio_conference":{"type":"boolean","description":"Whether the group has the [**Personal Audio Conference**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060449#h_01F5BPMNMERFWXN5S8ZJRZZCSE) setting enabled.","example":true},"participant_phone_masking":{"type":"boolean","description":"Whether the group has the [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5H1618B9AQ9F29NYRNE8W) setting enabled.","example":true}},"description":"The group's audio conference settings."},"email_notification":{"type":"object","properties":{"alternative_host_reminder":{"type":"boolean","description":"Notify the alternative host who is set or removed.","example":true},"cancel_meeting_reminder":{"type":"boolean","description":"Notify host and participants when the meeting is cancelled.","example":true,"deprecated":true},"cloud_recording_available_reminder":{"type":"boolean","description":"Whether to notify the host when a cloud recording is available.","example":true},"jbh_reminder":{"type":"boolean","description":"Notify host when participants join the meeting before them.","example":true},"schedule_for_reminder":{"type":"boolean","description":"Notify the host there is a meeting is scheduled, rescheduled, or cancelled.","example":true}}},"in_meeting":{"type":"object","properties":{"alert_guest_join":{"type":"boolean","description":"Allow participants who belong to your account to see that a guest (someone who does not belong to your account) is participating in the meeting/webinar.","example":true},"allow_users_to_delete_messages_in_meeting_chat":{"type":"boolean","description":"If the value of this field is set to `true`, allow users to delete messages in the in-meeting chat.\n","example":true},"allow_live_streaming":{"type":"boolean","description":"Whether to allow livestreaming.","example":true},"allow_show_zoom_windows":{"type":"boolean","description":"Show Zoom windows during screen share.","example":true},"annotation":{"type":"boolean","description":"Allow participants to use annotation tools to add information to shared screens.","example":true},"attendee_on_hold":{"type":"boolean","description":"Allow host to put attendee on hold.\n\n**This field has been deprecated and is no longer supported.**","example":true,"deprecated":true,"default":false},"auto_answer":{"type":"boolean","description":"Enable users to see and add contacts to 'auto-answer group' in the contact list on chat. Any call from members of this group will be automatically answered.","example":true},"auto_generated_captions":{"type":"boolean","description":"Whether to allow a live transcription service to transcribe meetings.","example":true},"auto_saving_chat":{"type":"boolean","description":"Automatically save all in-meeting chats.","example":true},"breakout_room":{"type":"boolean","description":"Allow host to split meeting participants into separate, smaller rooms.","example":true},"chat":{"type":"boolean","description":"Allow meeting participants to send chat message visible to all participants.","example":true},"meeting_question_answer":{"type":"boolean","description":"Allow participants to ask questions for the host and participants to answer.","example":true},"closed_caption":{"type":"boolean","description":"Allow host to type closed captions or assign a participant or third party device to add closed captions.","example":true},"co_host":{"type":"boolean","description":"Allow the host to add co-hosts. Co-hosts have the same in-meeting controls as the host.","example":true},"custom_data_center_regions":{"type":"boolean","description":"Displays whether or not custom [data center regions](https://support.zoom.us/hc/en-us/articles/360042411451-Selecting-data-center-regions-for-hosted-meetings-and-webinars) have been selected for meetings/webinars hosted by this group.","example":true},"disable_screen_sharing_for_host_meetings":{"type":"boolean","description":"Whether the **Disable desktop screen sharing for meetings you host** setting is enabled.","example":true},"disable_screen_sharing_for_in_meeting_guests":{"type":"boolean","description":"Whether the **Disable screen sharing when guests are in the meeting** setting is enabled.","example":true},"e2e_encryption":{"type":"boolean","description":"Require that all meetings are encrypted using AES.","example":true},"entry_exit_chime":{"type":"string","description":"Play sound when participants join or leave.","example":"all"},"far_end_camera_control":{"type":"boolean","description":"Allow another user to take control of the camera during a meeting.","example":true},"feedback":{"type":"boolean","description":"Enable users to provide feedback to Zoom at the end of the meeting.","example":true},"file_transfer":{"type":"boolean","description":"Indicates whether [in-meeting file transfer](https://support.zoom.us/hc/en-us/articles/209605493-In-meeting-file-transfer) setting has been enabled for the users in the group or not.","example":true},"full_transcript":{"type":"boolean","description":"Whether to allow the viewing of full transcripts in the in-meeting side panel.","example":true},"group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in a meeting. This will require more bandwidth.","example":true},"webinar_group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in a webinar. This will require more bandwidth.","example":true},"language_interpretation":{"type":"boolean","description":"Whether to allow hosts to assign participants as interpreters who can interpret one language into another in real-time.","example":true},"sign_language_interpretation":{"type":"boolean","description":"Allow hosts to assign participants as sign language interpreters who can interpret one language into sign language in real-time. Hosts can assign interpreters when scheduling, or during the meeting itself. This feature is only available with version 5.11.3 or later.","example":true},"manual_captions":{"type":"boolean","description":"Allow host to type closed captions or assign a participant or third party device to add closed captions.","example":true},"meeting_reactions":{"type":"boolean","description":"Whether meeting participants can [communicate using the emoji reactions](https://support.zoom.us/hc/en-us/articles/115001286183-Nonverbal-feedback-and-meeting-reactions) located in the **Reactions** menu in the meeting toolbar.","example":true},"webinar_reactions":{"type":"boolean","description":"Set this field to true to use [webinar reactions](https://support.zoom.us/hc/en-us/articles/4803536268429).","example":true},"meeting_survey":{"type":"boolean","description":"Whether the host can present a survey to participants once a meeting has ended. This feature is only available in version 5.7.3 or higher.","example":true},"non_verbal_feedback":{"type":"boolean","description":"Allow participants in a meeting can provide nonverbal feedback and express opinions by clicking on icons in the Participants panel.","example":true},"original_audio":{"type":"boolean","description":"Allow users to select original sound during a meeting.","example":true},"polling":{"type":"boolean","description":"Add 'Polls' to the meeting controls. This allows the host to survey the attendees.","example":true},"post_meeting_feedback":{"type":"boolean","description":"Display end-of-meeting experience feedback survey.","example":true},"private_chat":{"type":"boolean","description":"Allow meeting participants to send a private 1:1 message to another participant.","example":true},"remote_control":{"type":"boolean","description":"During screen sharing, allow the person who is sharing to let others control the shared content.","example":true},"remote_support":{"type":"boolean","description":"Allow meeting host to provide 1:1 remote support to another participant.","example":true},"request_permission_to_unmute_participants":{"type":"boolean","description":"Indicates whether the [**Request permission to unmute participants**](https://support.zoom.us/hc/en-us/articles/203435537-Muting-and-unmuting-participants-in-a-meeting#h_01EGK4XFWS1SJGZ71MYGKF7260) option has been enabled and locked for the group or not.","example":true},"save_caption":{"type":"boolean","description":"Whether participants can save closed captions or transcripts.","example":true},"save_captions":{"type":"boolean","description":"Whether participants can save closed captions or transcripts.","example":true},"screen_sharing":{"type":"boolean","description":"Allow host and participants to share their screen or content during meetings.","example":true},"sending_default_email_invites":{"type":"boolean","description":"Allow users to invite participants by email only by default.","example":true},"show_a_join_from_your_browser_link":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their browser and bypass the Zoom application download process. This is useful for participants who cannot download, install, or run applications. Note that the meeting experience from the browser is limited.","example":true},"show_browser_join_link":{"type":"boolean","description":"Allow participants to join a meeting directly from their browser.","example":true},"show_meeting_control_toolbar":{"type":"boolean","description":"Always show meeting controls during a meeting.","example":true},"slide_control":{"type":"boolean","description":"Whether the person sharing during a presentation can allow others to control the slide presentation. This feature is only available in version 5.8.3 or higher.","example":true},"stereo_audio":{"type":"boolean","description":"Allow users to select stereo audio during a meeting.","example":true},"use_html_format_email":{"type":"boolean","description":"Allow HTML formatting instead of plain text for meeting invitations scheduled with the Outlook plugin.","example":true},"virtual_background":{"type":"boolean","description":"Enable virtual backgrounds.","example":true},"waiting_room":{"type":"boolean","description":"Attendees cannot join a meeting until a host admits them individually from the waiting room.","example":true},"webinar_chat":{"type":"boolean","description":"Whether to allow webinar participants to send chat messages.","example":true},"webinar_live_streaming":{"type":"boolean","description":"Whether webinar livestreaming is enabled.","example":true},"webinar_polling":{"type":"boolean","description":"Whether the host can add polls before or during a webinar.","example":true},"webinar_question_answer":{"type":"boolean","description":"Whether attendees can ask the host and panelists questions in the webinar.","example":true},"webinar_survey":{"type":"boolean","description":"Whether the host can present surveys to attendees once a webinar has ended.","example":true},"whiteboard":{"type":"boolean","description":"Allow participants to share a whiteboard that includes annotation tools.","example":true}}},"other_options":{"type":"object","properties":{"blur_snapshot":{"type":"boolean","description":"If `true`, iOS blurs the screenshot in the task switcher when multiple apps are open. Android hides the screenshot in the system-level list of recent apps.","example":true}}},"recording":{"type":"object","properties":{"account_user_access_recording":{"type":"boolean","description":"Make cloud recordings accessible to account members only.","example":true},"auto_delete_cmr":{"type":"boolean","description":"Allow Zoom to automatically delete recordings permanently after a specified number of days.","example":true},"auto_recording":{"type":"boolean","description":"Record meetings automatically as they start.","example":true},"cloud_recording":{"type":"boolean","description":"Allow hosts to record and save the meeting or webinar in the cloud.","example":true},"cloud_recording_download":{"type":"boolean","description":"Allow anyone with a link to the cloud recording to download.","example":true},"host_delete_cloud_recording":{"type":"boolean","description":"Allow the host to delete the recordings. If this option is disabled, the recordings cannot be deleted by the host and only admin can delete them.","example":true},"ip_address_access_control":{"type":"object","properties":{"enable":{"type":"boolean","description":"If set to `true`, the cloud recordings of this account can only be accessed by the IP addresses defined in the `ip_addresses_or_ranges` property.\n\n","example":true},"ip_addresses_or_ranges":{"type":"string","description":"IP addresses or ranges that have access to the cloud recordings. Separate multiple IP ranges with commas. Use `n.n.n.n, n.n.n.n/n` or `n.n.n.n - n.n.n.n` syntax where n is a number, such as `46.33.24.184, 48.99.100.2/25` or `200.181.108.17 - 220.181.108.157`.\n\n","example":"200.181.108.17 - 220.181.108.157"}},"description":"Setting to allow cloud recording access only from specific IP address ranges.\n"},"local_recording":{"type":"boolean","description":"Allow hosts and participants to record the meeting to a local file.","example":true},"prevent_host_access_recording":{"type":"boolean","description":"If set to `true`, meeting hosts cannot view their meeting cloud recordings. Only the admins who have recording management privilege can access them.\n\n","example":true},"recording_authentication":{"type":"boolean","description":"Only authenticated users can view cloud recordings","example":true},"archive":{"type":"boolean","description":"[Archiving solution](https://support.zoom.us/hc/en-us/articles/360050431572-Archiving-Meeting-and-Webinar-data) settings. This setting can only be used if you have been granted archiving solution access by the Zoom support team.","example":true}}},"schedule_meeting":{"type":"object","properties":{"audio_type":{"type":"boolean","description":"Determine how participants can join the audio portion of the meeting.","example":true},"embed_password_in_join_link":{"type":"boolean","description":"If the value is set to `true`, the meeting passcode will be encrypted and included in the join meeting link to allow participants to join with just one click without having to enter the passcode.\n ","example":true},"force_pmi_jbh_password":{"type":"boolean","description":"If the join before host option is enabled for a personal meeting, then enforce passcode requirement.","example":true},"host_video":{"type":"boolean","description":"Start meetings with host video on.","example":true},"join_before_host":{"type":"boolean","description":"Allow participants to join the meeting before the host arrives","example":true},"meeting_authentication":{"type":"boolean","description":"Only authenticated users can join meetings","example":true},"mute_upon_entry":{"type":"boolean","description":"Automatically mute all participants when they join the meeting.","example":true},"participant_video":{"type":"boolean","description":"Start meetings with participant video on.","example":true},"pstn_password_protected":{"type":"boolean","description":"Generate and send new passcodes for newly scheduled or edited meetings.","example":true},"require_password_for_instant_meetings":{"type":"boolean","description":"Require passcode for instant meetings. If you use personal meeting ID (PMI) for your instant meetings, this option will be disabled.","example":true},"require_password_for_pmi_meetings":{"type":"boolean","description":"Require participants to enter passcode for PMI meetings.","example":true},"require_password_for_scheduling_new_meetings":{"type":"boolean","description":"This setting applies for regular meetings that do not use PMI. If enabled, a passcode will be generated while a host schedules a new meeting and participants will be required to enter the passcode before they can join the meeting.","example":true},"upcoming_meeting_reminder":{"type":"boolean","description":"Receive desktop notification for upcoming meetings.","example":true},"continuous_meeting_chat":{"type":"boolean","description":"Whether to enable the [**Enable continuous meeting chat**] setting.","example":true}}},"telephony":{"type":"object","properties":{"telephony_regions":{"type":"boolean","description":"Third party audio conference info.","example":true},"third_party_audio":{"type":"boolean","description":"Allow users to join the meeting using the existing third party audio configuration.","example":true}},"description":"Group Settings: Telephony."}}},{"title":"Meeting/Webinar Security Group Locked Settings","type":"object","properties":{"meeting_security":{"type":"object","properties":{"approved_or_denied_countries_or_regions":{"type":"boolean","description":"Whether the [**Approve or block entry for users from specific countries/regions**](https://support.zoom.us/hc/en-us/articles/360060086231-Joining-from-specific-countries-regions) setting is enabled.","example":true},"auto_security":{"type":"boolean","description":"Whether all meetings must be secured with at least one security option. \n\n This setting can only be disabled by Enterprise, ISV, Business (with more than 100 licenses), and Education accounts.","example":true},"block_user_domain":{"type":"boolean","description":"Whether users in specific domains are blocked from joining meetings and webinars.","example":true},"embed_password_in_join_link":{"type":"boolean","description":"Whether the meeting passcode is encrypted and included in the invitation link. The provided link will allow participants to join the meeting without having to enter the passcode.","example":true},"encryption_type":{"type":"string","description":"The type of encryption used when starting a meeting. \n* `enhanced_encryption` - Enhanced encryption. Encryption data is stored in the cloud. \n* `e2ee` - End-to-end encryption. The encryption key is stored on the local device and cannot be obtained by anyone else. Enabling E2EE also [**disables** certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":"enhanced_encryption","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Whether end-to-end encryption is enabled for meetings.","example":true},"meeting_password":{"type":"boolean","description":"Whether all instant and scheduled meetings that users can join via client or Zoom Rooms systems are passcode-protected. [Personal meeting ID (PMI)](https://support.zoom.us/hc/en-us/articles/203276937) meetings are **not** included in this setting.","example":true},"only_authenticated_can_join_from_webclient":{"type":"boolean","description":"Whether to specify that only authenticated users can join the meeting from the web client.","example":true},"phone_password":{"type":"boolean","description":"Whether passcodes are required for participants joining by phone. \n\n If enabled and the meeting is passcode-protected, a numeric passcode is required for participants to join by phone. For meetings with alphanumeric passcodes, a numeric passcode will be generated.","example":true},"pmi_password":{"type":"boolean","description":"Whether all PMI meetings that users can join via client or Zoom Rooms systems are passcode-protected.","example":true},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**waiting room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting. \n\n If the **Waiting Room** feature is enabled, the [**Allow participants to join before host**](https://support.zoom.us/hc/en-us/articles/202828525-Allow-participants-to-join-before-host) setting is automatically disabled.","example":true},"webinar_password":{"type":"boolean","description":"Whether to generate a passcode when scheduling webinars. Participants must use the generated passcode to join the scheduled webinar.","example":true}}}},"description":"The group's locked meeting and webinar security settings."}]}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n Group does not exist: {groupId}
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:lock_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:lock_settings:admin"]}},"patch":{"tags":["Groups"],"summary":"Update locked settings","description":"Update a [group's](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) locked settings. If you lock a setting, the group members cannot modify it individually. \n\n **Note:** The `force_pmi_jbh_password` field under meeting settings is deprecated as of September 22, 2019. \n\n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:update:lock_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupLockedSettings","parameters":[{"name":"groupId","in":"path","description":"The group's ID.","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}},{"name":"option","in":"query","description":"Optional query parameters.\n* `meeting_security` - View the meeting security settings applied to the user's account.","required":false,"schema":{"type":"string","example":"meeting_security"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"audio_conferencing":{"type":"object","properties":{"toll_free_and_fee_based_toll_call":{"type":"boolean","description":"Whether the group has the [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call#h_01F51844DRCX3K7BRTMZ40381R) setting enabled.","example":true},"toll_call":{"type":"boolean","description":"Whether the group has the [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F51680NJ7YHZDXGJNSKDGM2P) setting enabled.","example":true},"call_me_and_invite_by_phone":{"type":"boolean","description":"Whether the group has the [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VFZMDP4EJAF772N7NG2KY) setting enabled.","example":true},"personal_audio_conference":{"type":"boolean","description":"Whether the group has the [**Personal Audio Conference**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060449#h_01F5BPMNMERFWXN5S8ZJRZZCSE) setting enabled.","example":true},"participant_phone_masking":{"type":"boolean","description":"Whether the group has the [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5GT9P563K751K3JNAYE6E) setting enabled.","example":true}},"description":"The group's audio conference settings."},"email_notification":{"type":"object","properties":{"alternative_host_reminder":{"type":"boolean","description":"Notify the alternative host who is set or removed.","example":true},"cancel_meeting_reminder":{"type":"boolean","description":"Notify host and participants when the meeting is cancelled.","example":true},"cloud_recording_available_reminder":{"type":"boolean","description":"Whether to notify the host when a cloud recording is available.","example":true},"jbh_reminder":{"type":"boolean","description":"Notify the host when participants join the meeting before them.","example":true},"schedule_for_reminder":{"type":"boolean","description":"Notify the host there is a meeting is scheduled, rescheduled, or cancelled.","example":true}}},"in_meeting":{"type":"object","properties":{"alert_guest_join":{"type":"boolean","description":"Allow participants who belong to your account to see that a guest (someone who does not belong to your account) is participating in the meeting/webinar.","example":true},"allow_users_to_delete_messages_in_meeting_chat":{"type":"boolean","description":"If the value of this field is set to `true`, allow users to delete messages in the in-meeting chat.\n","example":true},"allow_live_streaming":{"type":"boolean","description":"Whether to allow livestreaming.","example":true},"allow_show_zoom_windows":{"type":"boolean","description":"Show Zoom windows during screen share.","example":true},"annotation":{"type":"boolean","description":"Allow participants to use annotation tools to add information to shared screens.","example":true},"attendee_on_hold":{"type":"boolean","description":"Allow host to put attendee on hold.\n\n**This field has been deprecated and is no longer supported.**","example":true,"default":false},"auto_answer":{"type":"boolean","description":"Enable users to see and add contacts to 'auto-answer group' in the contact list on chat. Any call from members of this group will be automatically answered.","example":true},"auto_generated_captions":{"type":"boolean","description":"Whether to allow a live transcription service to transcribe meetings.","example":true},"auto_saving_chat":{"type":"boolean","description":"Automatically save all in-meeting chats.","example":true},"breakout_room":{"type":"boolean","description":"Allow host to split meeting participants into separate, smaller rooms.","example":true},"chat":{"type":"boolean","description":"Allow meeting participants to send chat message visible to all participants.","example":true},"meeting_question_answer":{"type":"boolean","description":"Allow participants to ask questions for the host and participants to answer.","example":true},"closed_caption":{"type":"boolean","description":"Allow host to type closed captions or assign a participant/third party device to add closed captions.","example":true},"co_host":{"type":"boolean","description":"Allow the host to add co-hosts. Co-hosts have the same in-meeting controls as the host.","example":true},"custom_data_center_regions":{"type":"boolean","description":"Displays whether or not custom [data center regions](https://support.zoom.us/hc/en-us/articles/360042411451-Selecting-data-center-regions-for-hosted-meetings-and-webinars) have been selected for meetings/webinars hosted by this group.","example":true},"disable_screen_sharing_for_host_meetings":{"type":"boolean","description":"Whether to enable the **Disable desktop screen sharing for meetings you host** setting.","example":true},"disable_screen_sharing_for_in_meeting_guests":{"type":"boolean","description":"Whether to enable the **Disable screen sharing when guests are in the meeting** setting.","example":true},"e2e_encryption":{"type":"boolean","description":"Require that all meetings are encrypted using AES.","example":true},"entry_exit_chime":{"type":"string","description":"Play sound when participants join or leave.","example":"all"},"far_end_camera_control":{"type":"boolean","description":"Allow another user to take control of the camera during a meeting.","example":true},"feedback":{"type":"boolean","description":"Enable users to provide feedback to Zoom at the end of the meeting.","example":true},"file_transfer":{"type":"boolean","description":"Indicates whether [in-meeting file transfer](https://support.zoom.us/hc/en-us/articles/209605493-In-meeting-file-transfer) setting has been enabled for the users in the group or not.","example":true},"full_transcript":{"type":"boolean","description":"Whether to allow the viewing of full transcripts in the in-meeting side panel.","example":true},"group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in the meeting. This will require more bandwidth.","example":true},"webinar_group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in the webinar. This will require more bandwidth.","example":true},"language_interpretation":{"type":"boolean","description":"Whether to allow hosts to assign participants as interpreters who can interpret one language into another in real-time.","example":true},"sign_language_interpretation":{"type":"boolean","description":"Allow hosts to assign participants as sign language interpreters who can interpret one language into sign language in real-time. Hosts can assign interpreters when scheduling, or during the meeting itself. This feature is only available with version 5.11.3 or later.","example":true},"webinar_reactions":{"type":"boolean","description":"Set this field to true to use [webinar reactions](https://support.zoom.us/hc/en-us/articles/4803536268429).","example":true},"meeting_survey":{"type":"boolean","description":"Whether to allow the host to present a survey to participants once a meeting has ended. This feature is only available in version 5.7.3 or higher.","example":true},"non_verbal_feedback":{"type":"boolean","description":"Allow participants in a meeting can provide nonverbal feedback and express opinions by clicking on icons in the Participants panel.","example":true},"original_audio":{"type":"boolean","description":"Allow users to select original sound during a meeting.","example":true},"polling":{"type":"boolean","description":"Add 'Polls' to the meeting controls. This allows the host to survey the attendees.","example":true},"post_meeting_feedback":{"type":"boolean","description":"Display end-of-meeting experience feedback survey.","example":true},"private_chat":{"type":"boolean","description":"Allow meeting participants to send a private 1:1 message to another participant.","example":true},"remote_control":{"type":"boolean","description":"During screen sharing, allow the person who is sharing to let others control the shared content.","example":true},"remote_support":{"type":"boolean","description":"Allow meeting host to provide 1:1 remote support to another participant.","example":true},"request_permission_to_unmute_participants":{"type":"boolean","description":"Indicate whether the [**Request permission to unmute participants**](https://support.zoom.us/hc/en-us/articles/203435537-Muting-and-unmuting-participants-in-a-meeting#h_01EGK4XFWS1SJGZ71MYGKF7260) option should be enabled and locked for the group or not.","example":true},"save_caption":{"type":"boolean","description":"Whether to allow participants to save closed captions or transcripts.","example":true},"save_captions":{"type":"boolean","description":"Whether participants can save closed captions or transcripts.","example":true},"screen_sharing":{"type":"boolean","description":"Allow host and participants to share their screen or content during meetings.","example":true},"sending_default_email_invites":{"type":"boolean","description":"Allow users to invite participants by email only by default.","example":true},"show_a_join_from_your_browser_link":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their browser and bypass the Zoom application download process. This is useful for participants who cannot download, install, or run applications. Note that the meeting experience from the browser is limited.","example":true},"show_browser_join_link":{"type":"boolean","description":"Allow participants to join a meeting directly from their browser.","example":true},"show_meeting_control_toolbar":{"type":"boolean","description":"Always show meeting controls during a meeting.","example":true},"slide_control":{"type":"boolean","description":"Whether the person sharing during a presentation can allow others to control the slide presentation. This feature is only available in version 5.8.3 or higher.","example":true},"stereo_audio":{"type":"boolean","description":"Allow users to select stereo audio during a meeting.","example":true},"use_html_format_email":{"type":"boolean","description":"Allow HTML formatting instead of plain text for meeting invitations scheduled with the Outlook plugin.","example":true},"virtual_background":{"type":"boolean","description":"Enable virtual background.","example":true},"waiting_room":{"type":"boolean","description":"Attendees cannot join a meeting until a host admits them individually from the waiting room.","example":true},"webinar_chat":{"type":"boolean","description":"Whether to allow webinar participants to send chat messages.","example":true},"webinar_live_streaming":{"type":"boolean","description":"Whether webinar livestreaming is enabled.","example":true},"webinar_polling":{"type":"boolean","description":"Whether to allow the host to add polls before or during a webinar.","example":true},"webinar_question_answer":{"type":"boolean","description":"Whether attendees can ask the host and panelists questions in the webinar.","example":true},"webinar_survey":{"type":"boolean","description":"Whether to allow the host to present surveys to attendees once a webinar has ended.","example":true},"whiteboard":{"type":"boolean","description":"Allow participants to share a whiteboard that includes annotation tools.","example":true}}},"other_options":{"type":"object","properties":{"blur_snapshot":{"type":"boolean","description":"If `true`, iOS blurs the screenshot in the task switcher when multiple apps are open. Android hides the screenshot in the system-level list of recent apps.","example":true}}},"recording":{"type":"object","properties":{"account_user_access_recording":{"type":"boolean","description":"Make cloud recordings accessible to account members only.","example":true},"auto_delete_cmr":{"type":"boolean","description":"Allow Zoom to automatically delete recordings permanently after a specified number of days.","example":true},"auto_recording":{"type":"boolean","description":"Record meetings automatically as they start.","example":true},"cloud_recording":{"type":"boolean","description":"Allow hosts to record and save the meeting or webinar in the cloud.","example":true},"cloud_recording_download":{"type":"boolean","description":"Allow anyone with a link to the cloud recording to download.","example":true},"host_delete_cloud_recording":{"type":"boolean","description":"Allow the host to delete the recordings. If this option is disabled, the recordings cannot be deleted by the host and only admin can delete them.","example":true},"ip_address_access_control":{"type":"object","properties":{"enable":{"type":"boolean","description":"If set to `true`, the cloud recordings of this account can only be accessed by the IP addresses defined in the `ip_addresses_or_ranges` property.\n\n","example":true},"ip_addresses_or_ranges":{"type":"string","description":"IP addresses or ranges that have access to the cloud recordings. Separate multiple IP ranges with comma. Use n.n.n.n, n.n.n.n/n or n.n.n.n - n.n.n.n syntax where n is a number.\n\nExample: `46.33.24.184, 48.99.100.2/25` or `200.181.108.17 - 220.181.108.157`\n\n","example":"200.181.108.17 - 220.181.108.157"}},"description":"Setting to allow cloud recording access only from specific IP address ranges.\n"},"local_recording":{"type":"boolean","description":"Allow hosts and participants to record the meeting to a local file.","example":true},"recording_authentication":{"type":"boolean","example":true},"archive":{"type":"boolean","description":"[Archiving solution](https://support.zoom.us/hc/en-us/articles/360050431572-Archiving-Meeting-and-Webinar-data) settings. This setting can only be used if you have been granted archiving solution access by the Zoom support team.","example":true}}},"schedule_meeting":{"type":"object","properties":{"audio_type":{"type":"boolean","description":"Determine how participants can join the audio portion of the meeting.","example":true},"embed_password_in_join_link":{"type":"boolean","description":"If the value is set to `true`, the meeting passcode will be encrypted and included in the join meeting link to allow participants to join with just one click without having to enter the passcode.\n ","example":true},"force_pmi_jbh_password":{"type":"boolean","description":"If join before host option is enabled for a personal meeting, then enforce passcode requirement.","example":true,"deprecated":true},"host_video":{"type":"boolean","description":"Start meetings with host video on.","example":true},"join_before_host":{"type":"boolean","description":"Allow participants to join the meeting before the host arrives","example":true},"meeting_authentication":{"type":"boolean","description":"Only authenticated users can join meetings","example":true},"mute_upon_entry":{"type":"boolean","description":"Automatically mute all participants when they join the meeting.","example":true},"participant_video":{"type":"boolean","description":"Start meetings with participant video on.","example":true},"personal_meeting":{"type":"boolean","description":"Turn the lock setting on or off for the **Enable Personal Meeting ID** setting for a group. \n \n \n`true` - Turn the **Enable Personal Meeting ID** setting **on** for all users in the group. Users can choose to use personal meeting ID for their meetings. \n \n \n`false` - Turn **off** the **Enable Personal Meeting ID** setting. **If this setting is [disabled](https://support.zoom.us/hc/en-us/articles/201362843-Personal-meeting-ID-PMI-and-personal-link?flash_digest=eb7ac62d8c7fb4daf285916e3e15d87537806133#h_aa0335c8-3b06-41bc-bc1f-a8b84ef17f2a), meetings that were scheduled with PMI by this group members will be invalid. Users will have to update previously scheduled PMI meetings.** \n \n \nFor Zoom Phone only: If a user has been assigned a desk phone, **Elevate to Zoom Meeting** on desk phone will be disabled.\n\n\n","example":true},"pstn_password_protected":{"type":"boolean","description":"Generate and send new passcodes for newly scheduled or edited meetings.","example":true},"require_password_for_instant_meetings":{"type":"boolean","description":"Require passcode for instant meetings. If you use PMI for your instant meetings, this option is disabled.","example":true},"require_password_for_pmi_meetings":{"type":"boolean","description":"Require participants to enter passcode for PMI meetings.","example":true},"require_password_for_scheduling_new_meetings":{"type":"boolean","description":"This setting applies for regular meetings that do not use PMI. If enabled, a passcode is generated while a host schedules a new meeting and participants will be required to enter the passcode before they can join the meeting.","example":true},"upcoming_meeting_reminder":{"type":"boolean","description":"Receive desktop notification for upcoming meetings.","example":true},"continuous_meeting_chat":{"type":"boolean","description":"Whether to enable the [**Enable continuous meeting chat**] setting.","example":true}}},"telephony":{"type":"object","properties":{"telephony_regions":{"type":"boolean","description":"Indicates where most of the participants call into or call from during a meeting.","example":true},"third_party_audio":{"type":"boolean","description":"Allow users to join the meeting using the existing 3rd party audio configuration.","example":true}},"description":"Group Settings: Telephony."}}},{"title":"Meeting/Webinar Security Group Locked Settings","type":"object","properties":{"meeting_security":{"type":"object","properties":{"approved_or_denied_countries_or_regions":{"type":"boolean","description":"Whether to enable the [**Approve or block entry for users from specific countries or regions**](https://support.zoom.us/hc/en-us/articles/360060086231-Joining-from-specific-countries-regions) setting.","example":true},"auto_security":{"type":"boolean","description":"Whether to require that all meetings are secured with at least one security option. \n\n This setting can only be disabled by Enterprise, ISV, Business (with more than 100 licenses), and Education accounts.","example":true},"block_user_domain":{"type":"boolean","description":"Whether to block users in specific domains from joining meetings and webinars.","example":true},"embed_password_in_join_link":{"type":"boolean","description":"Whether the meeting passcode will be encrypted and included in the invitation link. The provided link will allow participants to join the meeting without having to enter the passcode.","example":true},"encryption_type":{"type":"string","description":"The type of encryption to use when starting a meeting. \n* `enhanced_encryption` - Use enhanced encryption. Encryption data is stored in the cloud. \n* `e2ee` — End-to-end encryption. The encryption key is stored on the local device and cannot be obtained by anyone else. Enabling E2EE also [**disables** certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":"enhanced_encryption","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Whether to enable end-to-end encryption for meetings. If enabled, you can specify the type of encryption in the `encryption_type` field.","example":true},"meeting_password":{"type":"boolean","description":"Whether all instant and scheduled meetings that users can join via client or Zoom Rooms systems are passcode-protected. [Personal Meeting ID (PMI)](https://support.zoom.us/hc/en-us/articles/203276937) meetings are **not** included in this setting.","example":true},"only_authenticated_can_join_from_webclient":{"type":"boolean","description":"Whether to specify that only authenticated users can join the meeting from the web client.","example":true},"phone_password":{"type":"boolean","description":"Whether to require a passcode for participants joining by phone. \n\n If enabled and the meeting is passcode-protected, a numeric passcode is required for participants to join by phone. For meetings with alphanumeric passcodes, a numeric passcode will be generated.","example":true},"pmi_password":{"type":"boolean","description":"Whether all personal meeting ID (PMI) meetings that users can join via client or Zoom Rooms systems are passcode-protected.","example":true},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting. \n\n If the **Waiting Room** feature is enabled, the [**Allow participants to join before host**](https://support.zoom.us/hc/en-us/articles/202828525-Allow-participants-to-join-before-host) setting is automatically disabled.","example":true},"webinar_password":{"type":"boolean","description":"Whether to generate a passcode when scheduling webinars. Participants must use the generated passcode to join the scheduled webinar.","example":true}}}},"description":"The group's updated locked meeting and webinar security settings."}]}}}},"responses":{"204":{"description":"**Status Code:** `204` \n \nGroup's locked settings updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for paid account.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n This group does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:update:lock_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:update:lock_settings:admin"]}}},"/groups/{groupId}/members":{"get":{"tags":["Groups"],"summary":"List group members ","description":"List the members of a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under your account.\n\n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:list_members:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupMembers","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":2000,"type":"integer","example":30,"default":30}},{"name":"page_number","in":"query","description":"**Deprecated.** We will no longer support this field in a future release. Instead, use the `next_page_token` for pagination.","required":false,"schema":{"type":"integer","example":1,"default":1}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n List of group members returned.","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"maxItems":2000,"type":"array","description":"List of a Group Members","items":{"type":"object","properties":{"email":{"type":"string","description":"User's email address.","example":"jchill@example.com"},"first_name":{"type":"string","description":"First name of the user.","example":"Jill"},"id":{"type":"string","description":"Unique Identifier of the user. ","example":"v4iyWT1LTfy8QvPG4GTvdg"},"last_name":{"type":"string","description":"Last name of the user.","example":"Chill"},"type":{"type":"integer","description":"User type: \n `1` - Basic \n `2` - Licensed","example":1}}}},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"},"page_count":{"type":"integer","description":"The number of pages returned from this request.","example":20},"page_number":{"type":"integer","description":"The page number of the current results.","example":1},"page_size":{"type":"integer","description":"The number of records returned from a single API call.","example":10},"total_records":{"type":"integer","description":"The total number of records available across all pages.","example":200}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account.
\n**Error Code:** `300`
\n The next page token is invalid or expired.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:list_members:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:list_members:admin"]}},"post":{"tags":["Groups"],"summary":"Add group members","description":"Use this API to add users to a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) in your account.\n\n**Prerequisites:** \n* A Pro, Business, or Education account\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:member:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupMembersCreate","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"members":{"maximum":30,"maxItems":30,"type":"array","description":"List of Group members","items":{"type":"object","properties":{"email":{"type":"string","description":"User email. If the user ID is given then the user email should be ignored.","example":"jchill@example.com"},"id":{"type":"string","description":"User ID.","example":"v4iyWT1LTfy8QvPG4GTvdg"}}}}}}}}},"responses":{"201":{"description":"Member added.","content":{"application/json":{"schema":{"type":"object","properties":{"added_at":{"type":"string","description":"The timestamp when the group member was added.","format":"date-time","example":"2022-03-25T03:08:12Z"},"ids":{"type":"string","description":"The IDs of the group members.","example":"v4iyWT1LTfy8QvPG4GTvdg"}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for paid account,{accountId}.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:write:member:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:write:member:admin"]}}},"/groups/{groupId}/members/{memberId}":{"delete":{"tags":["Groups"],"summary":"Delete a group member","description":"Use this API to remove a user from a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) in an account.\n\n**Prerequisites:** \n* A Pro, Business, or Education account\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:delete:member:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"groupMembersDelete","parameters":[{"name":"groupId","in":"path","description":"The group ID. \n \nRetrieve by calling the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}},{"name":"memberId","in":"path","description":"The member ID or email address.","required":true,"schema":{"type":"string","example":"-cn1DHGRRTSOlnVwyZNhKw"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content** Group member deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `1010`
\n Group does not belong to this account:{accountId}.
\n**Error Code:** `200`
\n Only available for Paid account.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n**Error Code:** `4131`
\n Group member does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:delete:member:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:delete:member:admin"]}},"patch":{"tags":["Groups"],"summary":"Update a group member","description":"Use this API to perform either of the following tasks: \n* Remove a group member from one group and move them to a different group. \n* Set a user's primary group. By default, the primary group is the first group that user is added to.\n\nIf a user is a member of multiple groups, you can [assign the user a primary group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-#h_d07c7dcd-4fd8-485a-b5fe-a322e8d21c09). The user will use the primary group's settings by default. However, if the user is a member of a group with locked settings, those group settings will remain locked to the user.\n\n**Prerequisites:** \n* A Pro or higher account\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:update:member:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateAGroupMember","parameters":[{"name":"groupId","in":"path","description":"The group's unique ID. To get this value, use the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API.\n* To set a user's primary group, use the `target_group_id` value for this parameter's value. \n* To move a group member from one group to another, use the `groupId` of the designated group.","required":true,"schema":{"type":"string","example":"SobVexyrQjqCkcxjpBWi6w"}},{"name":"memberId","in":"path","description":"The group member's unique ID. To get this value, use the [**List group members**](/docs/api-reference/zoom-api/methods#operation/groupMembers) API.","required":true,"schema":{"type":"string","example":"v4iyWT1LTfy8QvPG4GTvdg"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["action"],"type":"object","properties":{"action":{"type":"string","description":"The action to perform: \n* `move` — Remove the group member from one group and move them to a different group. \n* `set_primary` — Set the user's primary group.","example":"move","enum":["move","set_primary"]},"target_group_id":{"type":"string","description":"The target group's ID. To get this value, use the [**List groups**](/docs/api-reference/zoom-api/methods#operation/groups) API. \n* To set a user's primary group, use the designated primary group's `groupId` value. \n* To move a group member from one group to another, use the `groupId` of the designated group.","example":"SobVexyrQjqCkcxjpBWi6w"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content** \n \nGroup member updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account, {accountId}.
\n**Error Code:** `300`
\n The target_group_id can not be empty.
\n**Error Code:** `1010`
\n Group does not belong to this account:{accountId}.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n**Error Code:** `4131`
\n Group member does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:update:member:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:update:member:admin"]}}},"/groups/{groupId}/settings":{"get":{"tags":["Groups"],"summary":"Get a group's settings","description":"Get settings for a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-). \n\n**Prerequisite**: Pro, Business, or Education account.\n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getGroupSettings","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}},{"name":"option","in":"query","description":"Optional query parameters. \n* `meeting_authentication` - View the [meeting authentication settings](https://support.zoom.us/hc/en-us/articles/360037117472-Authentication-Profiles-for-Meetings-and-Webinars) applied to the user's account. \n* `recording_authentication` - View the [recording authentication settings](https://support.zoom.us/hc/en-us/articles/360037756671-Authentication-Profiles-for-Cloud-Recordings) applied to the user's account. \n* `meeting_security` - View the meeting security settings applied to the user's account.","required":false,"schema":{"type":"string","example":"meeting_security","enum":["meeting_authentication","recording_authentication","meeting_security"]}},{"name":"custom_query_fields","in":"query","description":"Provide the name of the field to use to filter the response. For example, if you provide `host_video` as the value of this field, you will get a response similar to this: \n\n{\n `schedule_meeting`: {\n `host_video`: false\n }\n} \n\nProvide multiple values by separating them with commas, such as `host_video,participant_video`.","required":false,"schema":{"type":"string","example":"host_video"}}],"responses":{"200":{"description":"**HTTP Status Code**: `200` \n \nGroup Settings Returned.\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"audio_conferencing":{"type":"object","properties":{"toll_free_and_fee_based_toll_call":{"type":"object","properties":{"allow_webinar_attendees_dial":{"type":"boolean","description":"Whether webinar attendees can dial in through the account's **Toll-free and Fee-based Toll Call** phone numbers. This feature is only available in version 5.2.2 and higher.","example":true},"enable":{"type":"boolean","description":"Whether the group has the [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call#h_01F51844DRCX3K7BRTMZ40381R) setting enabled.","example":true},"numbers":{"maxItems":100,"type":"array","description":"The group's **Toll-free and Fee-based Toll Call** phone number information.","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's [E.164 country calling code](https://en.wikipedia.org/wiki/List_of_country_calling_codes).","example":"86"},"country_code":{"type":"string","description":"The phone number's [country code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries).","example":"CN"},"country_name":{"type":"string","description":"The country name.","example":"China"},"display_number":{"maxLength":30,"type":"string","description":"The phone number's display number.","example":"+86 7777 777"},"number":{"maxLength":30,"type":"string","description":"The phone number.","example":"7777 777"}}}}},"description":"The group's [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call#h_01F51844DRCX3K7BRTMZ40381R) settings."},"toll_call":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the group has the [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F51844DRCX3K7BRTMZ40381R) setting enabled.","example":true},"numbers":{"type":"array","description":"The group's **Toll Call** phone number information.","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's [E.164 country calling code](https://en.wikipedia.org/wiki/List_of_country_calling_codes).","example":"86"},"country_code":{"type":"string","description":"The phone number's two letter [country code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries).","example":"CN"},"country_name":{"type":"string","description":"The country name.","example":"China"},"display_number":{"maxLength":30,"type":"string","description":"The phone number's display number.","example":"+86 777 777 77"},"number":{"maxLength":30,"type":"string","description":"The phone number.","example":"777 777 77"}}}}},"description":"The group's [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F51844DRCX3K7BRTMZ40381R) settings."},"call_me_and_invite_by_phone":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the group has the [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VG7NCJDZ238VVXZDJ8QMH) setting enabled.","example":true},"require_press_1_for_call_me":{"type":"string","description":"Require Call Me users to press 1 before being connected to the meeting. \n* `auto` - Automatically determine whether to require pressing 1 before connecting to the meeting. \n* `always` - Always require Call Me users to press 1 before connecting to the meeting. \n* `never` - Never require Call Me users to press 1 before connecting to the meeting.","example":"auto","enum":["auto","always","never"],"x-enum-descriptions":["Automatically determine whether to require pressing 1 before connecting to the meeting.","Always require Call Me users to press 1 before connecting to the meeting.","Never require Call Me users to press 1 before connecting to the meeting."]},"allow_webinar_attendees_call_me":{"type":"boolean","description":"Whether webinar attendees can use Call Me to connect audio. This feature is only available in version 5.2.2 and higher.","example":true},"call_out_countries":{"type":"object","properties":{"allowed_countries":{"type":"array","description":"The list of all available countries/regions that can be enabled for call out.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"selected_countries":{"type":"array","description":"The list of countries/regions that users can call out to.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}}},"description":"The group's call out countries/regions settings."}},"description":"The group's [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VG7NCJDZ238VVXZDJ8QMH) settings."},"personal_audio_conference":{"type":"boolean","description":"Whether the group has the [**Personal Audio Conference**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060449#h_01F5BPMNMERFWXN5S8ZJRZZCSE) setting enabled.","example":true},"participant_phone_masking":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the group has the [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5H1618B9AQ9F29NYRNE8W) setting enabled.","example":true},"masking_type":{"type":"string","description":"The type of phone number masking pattern to apply. \n* `mask_default` - Default masking pattern (Example: 888****666). \n* `mask_first_5` - Mask first five digits (Example: *****66666). \n* `mask_except_last_4` - Mask everything except last four digits (Example: *****6666).","example":"mask_default","enum":["mask_default","mask_first_5","mask_except_last_4"],"x-enum-descriptions":["Default masking pattern (Example: 888****666).","Mask first five digits (Example: *****66666).","Mask everything except last four digits (Example: *****6666)."]}},"description":"The group's [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5H1618B9AQ9F29NYRNE8W) settings."},"global_dial_in_countries":{"type":"object","properties":{"allowed_countries":{"type":"array","description":"The list of all available countries/regions that can be selected for displaying dial-in numbers in the meeting invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"selected_countries":{"type":"array","description":"The list of selected countries/regions whose dial-in numbers will be listed in the email invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"include_toll_free":{"type":"boolean","description":"Whether to include toll-free numbers in the email invitation for the selected countries/regions.","example":true}},"description":"The group's [**Global Dial-in Countries/Regions**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0068094#h_01F5KK9RF10NA325STVQP8TYER) settings."}},"description":"The group's audio conference settings."},"email_notification":{"type":"object","properties":{"alternative_host_reminder":{"type":"boolean","description":"Notify the alternative host who is set or removed.","example":true},"cancel_meeting_reminder":{"type":"boolean","description":"Notify host and participants when the meeting is cancelled.","example":true},"cloud_recording_available_reminder":{"type":"boolean","description":"Whether to notify the host when a cloud recording is available.","example":true},"jbh_reminder":{"type":"boolean","description":"Notify host when participants join the meeting before them.","example":true},"recording_available_reminder_alternative_hosts":{"type":"boolean","description":"Whether to notify any alternative hosts when a cloud recording is available.","example":true},"recording_available_reminder_schedulers":{"type":"boolean","description":"Whether to notify the person who scheduled the meeting or webinar for the host when a cloud recording is available.","example":true},"schedule_for_reminder":{"type":"boolean","description":"Notify the host there is a meeting is scheduled, rescheduled, or cancelled.","example":true}}},"in_meeting":{"type":"object","properties":{"alert_guest_join":{"type":"boolean","description":"Allow participants who belong to your account to see that a guest (someone who does not belong to your account) is participating in the meeting or webinar.","example":true},"allow_users_to_delete_messages_in_meeting_chat":{"type":"boolean","description":"If the value of this field is set to `true`, allow users to delete messages in the in-meeting chat.\n","example":true},"allow_live_streaming":{"type":"boolean","description":"Whether livestreaming is enabled.","example":true},"allow_participants_chat_with":{"type":"integer","description":"Whether to allow participants to only chat with certain groups.\n* `1` - The participant cannot use chat.\n* `2` - Host and co-hosts only.\n * `3` - The participant can chat with other participants publicly.\n* `4` - The participant can chat with other participants publicly and privately.\n\n**Note:** This setting is only available with client versions 5.7.3 and above.","example":1,"enum":[1,2,3,4],"x-enum-descriptions":["No one","Host and co-hosts","Everyone","Everyone and anyone directly"]},"allow_show_zoom_windows":{"type":"boolean","description":"Show Zoom windows during screen share.","example":true},"allow_users_save_chats":{"type":"integer","description":"Whether to allow participants to save meeting chats.\n* `1` - Participants cannot save meeting chats.\n* `2` - Participants can only save host and co-host meeting chats.\n* `3` - Participants can save all meeting chats.","example":1,"enum":[1,2,3],"x-enum-descriptions":["Not allow","Host and co-hosts","Everyone"]},"annotation":{"type":"boolean","description":"Allow participants to use annotation tools to add information to shared screens.","example":true},"attendee_on_hold":{"type":"boolean","description":"Allow the host to put an attendee on hold.\n\n**This field has been deprecated and is no longer supported.**","example":true,"default":false},"auto_answer":{"type":"boolean","description":"Enable users to see and add contacts to 'auto-answer group' in the contact list on chat. Any call from members of this group will be automatically answered.","example":true},"auto_saving_chat":{"type":"boolean","description":"Automatically save all in-meeting chats.","example":true},"breakout_room":{"type":"boolean","description":"Allow the host to split meeting participants into separate, smaller rooms.","example":true},"breakout_room_schedule":{"type":"boolean","description":"Whether the host can assign participants to breakout rooms when scheduling. This feature is **only** available in version 4.5.0 or higher.","example":true},"chat":{"type":"boolean","description":"Allow meeting participants to send chat message visible to all participants.","example":true},"meeting_question_answer":{"type":"boolean","description":"Allow participants to ask questions for the host and participants to answer.","example":true},"closed_caption":{"type":"boolean","description":"Allow the host to type closed captions or assign a participant/third party device to add closed captions.","example":true},"closed_captioning":{"type":"object","properties":{"auto_transcribing":{"type":"boolean","description":"Whether to allow a live transcription service to transcribe meetings.","example":true},"enable":{"type":"boolean","description":"Whether to allow the host to type closed captions or assign a participant or 3rd-party service to provide closed captioning.","example":true},"save_caption":{"type":"boolean","description":"Whether to allow participants to save closed captions or transcripts.","example":true},"third_party_captioning_service":{"type":"boolean","description":"Whether to allow the use of an API token to integrate with 3rd-party closed captioning services.","example":true},"view_full_transcript":{"type":"boolean","description":"Whether to allow the viewing of full transcripts in the in-meeting side panel.","example":true}},"description":"Information about the group's closed captioning settings."},"co_host":{"type":"boolean","description":"Allow the host to add co-hosts. Co-hosts have the same in-meeting controls as the host.","example":true},"custom_data_center_regions":{"type":"boolean","description":"If set to `true`, you can [select data center regions](https://support.zoom.us/hc/en-us/articles/360042411451-Selecting-data-center-regions-for-hosted-meetings-and-webinars) to be used by this group for hosting their real-time meeting and webinar traffic. These regions can be provided in the `data_center_regions` field. If set to `false`, the regions cannot be customized and the default regions will be used.","example":true},"custom_live_streaming_service":{"type":"boolean","description":"Whether custom livestreaming is enabled.","example":true},"custom_service_instructions":{"type":"string","description":"The specific instructions to allow your account's meeting hosts to configure a custom livestream.","example":"The specific instructions"},"data_center_regions":{"type":"array","description":"If the value of `custom_data_center_regions` is `true`, a comma-separated list of these [data center regions](https://support.zoom.us/hc/en-us/articles/360059254691-Datacenter-abbreviation-list) to opt in to. \n* `AU` - Australia.\n* `LA` - Latin America. \n* `CA` - Canada. \n* `CN` - China. \n* `DE` - Germany. \n* `HK` - Hong Kong SAR. \n* `IN` - India. \n* `IE` - Ireland. \n* `TY` - Japan. \n* `MX` - Mexico. \n* `NL` - Netherlands. \n* `SG` - Singapore. \n* `US` - United States.","items":{"type":"string","example":"AU","enum":["AU","LA","CA","CN","DE","HK","IN","IE","TY","MX","NL","SG","US"]}},"disable_screen_sharing_for_host_meetings":{"type":"boolean","description":"Whether the **Disable desktop screen sharing for meetings you host** setting is enabled.","example":true},"disable_screen_sharing_for_in_meeting_guests":{"type":"boolean","description":"Whether the **Disable screen sharing when guests are in the meeting** setting is enabled.","example":true},"e2e_encryption":{"type":"boolean","description":"Require that all meetings are encrypted using AES.","example":true},"entry_exit_chime":{"type":"string","description":"Play sound when participants join or leave.","example":"all"},"far_end_camera_control":{"type":"boolean","description":"Allow another user to take control of the camera during a meeting.","example":true},"feedback":{"type":"boolean","description":"Enable users to provide feedback to Zoom at the end of the meeting.","example":true},"file_transfer":{"type":"boolean","description":"Indicates whether [in-meeting file transfer](https://support.zoom.us/hc/en-us/articles/209605493-In-meeting-file-transfer) setting has been enabled for the users in the group or not.","example":true},"group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in the meeting. This requires more bandwidth.","example":true},"webinar_group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in the webianr. This requires more bandwidth.","example":true},"join_from_desktop":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their desktop browser. Note that the meeting experience from the desktop browser is limited.","example":true},"join_from_mobile":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their mobile browser. Note that the meeting experience from the mobile browser is limited.","example":true},"auto_generated_translation":{"type":"object","properties":{"language_item_pairList":{"type":"object","properties":{"trans_lang_config":{"type":"array","description":"A list of spoken languages and translation languages.","items":{"type":"object","properties":{"speak_language":{"type":"object","properties":{"name":{"type":"string","description":"The language's name.","example":"Chinese (Simplified)","enum":["Chinese (Simplified)","Dutch","English","French","German","Italian","Japanese","Korean","Portuguese","Russian","Spanish","Ukrainian"]},"code":{"type":"string","description":"The code for the language.","example":"zh","enum":["zh","nl","en","fr","de","it","ja","ko","pt","ru","es","uk"]}},"description":"The language used in meetings."},"translate_to":{"type":"object","properties":{"all":{"type":"boolean","description":"Whether to select all the translation languages.","example":true},"language_config":{"type":"array","description":"A list of the translation languages.","items":{"type":"object","properties":{"name":{"type":"string","description":"The translation language's name.","example":"English","enum":["English"]},"code":{"type":"string","description":"The translation language's code.","example":"en","enum":["en"]}},"description":"A item of translation languages."}}},"description":"Information about all the translation languages."}},"description":"A item of spoken language and translation languages in meetings."}},"all":{"type":"boolean","description":"Whether to select all spoken languages and translation languages.","example":true}},"description":"Information about all spoken languages and translation languages in meetings."},"enable":{"type":"boolean","description":"Whether to allow users to enable automated translated captions in these language pairs in meetings.","example":true}},"description":"Information about the [Translate captions](https://support.zoom.us/hc/en-us/articles/8158738379917-Managing-automated-captions-) settings in meetings."},"language_interpretation":{"type":"object","properties":{"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"English"}},"enable_language_interpretation_by_default":{"type":"boolean","description":"Whether to enable language interpretation by default.","example":true},"allow_participants_to_speak_in_listening_channel":{"type":"boolean","description":"Whether to allow participants to speak in listening channel.","example":true},"allow_up_to_25_custom_languages_when_scheduling_meetings":{"type":"boolean","description":"Whether to allow up to 25 custom languages when scheduling meetings.","example":true},"enable":{"type":"boolean","description":"Whether to allow hosts to assign participants as interpreters who can interpret one language into another in real-time.","example":true},"languages":{"type":"array","description":"A list of system-supported languages.","items":{"type":"string","example":"English"},"enum":["English","Chinese","Japanese","German","French","Russian","Portuguese","Spanish","Korean"]}},"description":"Information about the [language interpretation](https://support.zoom.us/hc/en-us/articles/360034919791-Using-Language-Interpretation-in-your-meeting-or-webinar) settings."},"sign_language_interpretation":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow hosts to assign participants as sign language interpreters who can interpret one language into another in real-time.","example":true},"enable_sign_language_interpretation_by_default":{"type":"boolean","description":"Whether to enable sign language interpretation view by default in scheduler.","example":true},"languages":{"type":"array","description":"A list of system-supported languages.","items":{"type":"string","example":"American","enum":["American","Chinese","French","German","Japanese","Russian","Brazilian","Spanish","Mexican","British"]}},"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"Language1"}}},"description":"Allow hosts to assign participants as sign language interpreters who can interpret one language into sign language in real-time. Hosts can assign interpreters when scheduling, or during the meeting itself. This feature is only available with version 5.11.3 or later."},"live_streaming_facebook":{"type":"boolean","description":"Whether Facebook livestreaming is enabled.","example":true},"live_streaming_youtube":{"type":"boolean","description":"Whether YouTube livestreaming is enabled.","example":true},"manual_captioning":{"type":"object","properties":{"allow_to_type":{"type":"boolean","description":"Whether to allow the host to manually caption or let the host assign a participant to provide manual captioning.","example":true},"auto_generated_captions":{"type":"boolean","description":"Whether to enable Zoom's [live transcription feature](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription#h_01FHGGHYJ4457H4GSZY0KM3NSB).","example":true},"full_transcript":{"type":"boolean","description":"Whether to enable the viewing of full transcripts in the in-meeting side panel.","example":true},"manual_captions":{"type":"boolean","description":"Whether to [enable manual closed captioning](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription).","example":true},"save_captions":{"type":"boolean","description":"Whether to allow participants to [save closed captions or transcripts](https://support.zoom.us/hc/en-us/articles/360060958752). \n\n **Note:** If the `full_transcript` field is set to `false`, participants **cannot** save captions.","example":true},"third_party_captioning_service":{"type":"boolean","description":"Whether to allow the use of an API token to integrate with a [3rd-party device](https://support.zoom.us/hc/en-us/articles/115002212983) to provide closed captioning.","example":true}},"description":"Information about manual captioning settings."},"meeting_reactions":{"type":"boolean","description":"Whether meeting participants can [communicate using the emoji reactions](https://support.zoom.us/hc/en-us/articles/115001286183-Nonverbal-feedback-and-meeting-reactions) located in the **Reactions** menu in the meeting toolbar.","example":true},"meeting_reactions_emojis":{"type":"string","description":"Choose from the following meeting reaction options.\n* `all` - All emojis: Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.\n* `selected` - Selected emojis: Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration) ","example":"all","enum":["all","selected"],"x-enum-descriptions":["Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.","Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration) ."]},"allow_host_panelists_to_use_audible_clap":{"type":"boolean","description":"Whether to allow hosts and panelists to use audible clap.","example":true},"webinar_reactions":{"type":"boolean","description":"Set this field to `true` to use [webinar reactions](https://support.zoom.us/hc/en-us/articles/4803536268429).","example":true},"meeting_survey":{"type":"boolean","description":"Whether to allow the host to present a survey to participants once a meeting has ended. This feature is only available in version 5.7.3 or higher.","example":true},"non_verbal_feedback":{"type":"boolean","description":"Allow participants in a meeting to provide nonverbal feedback and express opinions by clicking on icons in the participants panel.","example":true},"only_host_view_device_list":{"type":"boolean","description":"Show the list of H.323/SIP devices only to the host.","example":true},"original_audio":{"type":"boolean","description":"Allow users to select original sound during a meeting.","example":true},"polling":{"type":"boolean","description":"Add 'Polls' to the meeting controls. This allows the host to survey the attendees.","example":true},"post_meeting_feedback":{"type":"boolean","description":"Display end-of-meeting experience feedback survey.","example":true},"private_chat":{"type":"boolean","description":"Allow meeting participants to send a private 1:1 message to another participant.","example":true},"record_play_own_voice":{"type":"boolean","description":"When each participant joins by telephone, allow the option to record and play their own voice as entry and exit chimes.","example":true},"remote_control":{"type":"boolean","description":"During screen sharing, allow the person who is sharing to let others control the shared content.","example":true},"remote_support":{"type":"boolean","description":"Allow meeting host to provide 1:1 remote support to another participant.","example":true},"request_permission_to_unmute_participants":{"type":"boolean","description":"Indicates whether the [**Request permission to unmute participants**](https://support.zoom.us/hc/en-us/articles/203435537-Muting-and-unmuting-participants-in-a-meeting#h_01EGK4XFWS1SJGZ71MYGKF7260) option has been enabled for the group or not.","example":true},"screen_sharing":{"type":"boolean","description":"Allow host and participants to share their screen or content during meetings.","example":true},"sending_default_email_invites":{"type":"boolean","description":"Allow users to invite participants by email only by default.","example":true},"show_a_join_from_your_browser_link":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their browser and bypass the Zoom application download process. This is useful for participants who cannot download, install, or run applications. Note that the meeting experience from the browser is limited.","example":true},"show_browser_join_link":{"type":"boolean","description":"Allow participants to join a meeting directly from their browser.","example":true},"show_device_list":{"type":"boolean","description":"Show the list of H.323/SIP devices.","example":true},"show_meeting_control_toolbar":{"type":"boolean","description":"Always show meeting controls during a meeting.","example":true},"slide_control":{"type":"boolean","description":"Whether the person sharing during a presentation can allow others to control the slide presentation. This feature is only available in version 5.8.3 or higher.","example":true},"stereo_audio":{"type":"boolean","description":"Allow users to select stereo audio during a meeting.","example":true},"unchecked_data_center_regions":{"type":"array","description":"If the value of `custom_data_center_regions` is `true`, a comma-separated list of these [data center regions](https://support.zoom.us/hc/en-us/articles/360059254691-Datacenter-abbreviation-list) to **not** opt in to. \n* `EU` - Europe. \n* `HK` - Hong Kong. \n* `AU` - Australia. \n* `IN` - India. \n* `LA` - Latin America. \n* `TY` - Tokyo. \n* `CN` - China. \n* `US` - United States. \n* `CA` - Canada.","items":{"type":"string","example":"EU"},"enum":["EU","HK","AU","IN","TY","CN","US","CA","DE","NL","LA"]},"use_html_format_email":{"type":"boolean","description":"Allow HTML formatting instead of plain text for meeting invitations scheduled with the Outlook plugin.","example":true},"virtual_background":{"type":"boolean","description":"Enable virtual backgrounds.","example":true},"virtual_background_settings":{"type":"object","properties":{"allow_upload_custom":{"type":"boolean","description":"Allow users to upload custom backgrounds.","example":true},"allow_videos":{"type":"boolean","description":"Allow use of videos for virtual backgrounds.","example":true},"enable":{"type":"boolean","description":"Enable virtual backgrounds.","example":true},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The file's unique identifier.","example":"fawegw4tq43t35h4nhgfnethswe"},"is_default":{"type":"boolean","description":"Indicates whether or not this file is the default virtual background file.","example":true},"name":{"type":"string","description":"File name.","example":"File name"},"size":{"type":"integer","description":"File size.","example":1435},"type":{"type":"string","description":"File type.","example":"image"}}}}},"description":"Settings to manage virtual background."},"waiting_room":{"type":"boolean","description":"Attendees can't join a meeting until a host admits them individually from the waiting room.","example":true},"webinar_chat":{"type":"object","properties":{"allow_attendees_chat_with":{"type":"integer","description":"Allow webinar attendees to chat with other attendees.\n* `1` - No one.\n* `2` - Host and all panelists.\n* `3` - Everyone.","example":1,"enum":[1,2,3]},"allow_auto_save_local_chat_file":{"type":"boolean","description":"Whether to automatically save chat messages to a local file on the host's computer when the webinar ends.","example":true},"allow_panelists_chat_with":{"type":"integer","description":"Allow webinar panelists to chat with other attendees.\n* `1` - Host and all panelists.\n* `2` - Everyone.","example":2,"enum":[1,2]},"allow_panelists_send_direct_message":{"type":"boolean","description":"Whether to allow webinar panelists to send direct messages to other panelists.","example":true},"allow_users_save_chats":{"type":"integer","description":"Whether to allow webinar attendees to save chats.\n* `0` - Attendees cannot save chats.\n* `1` - Attendees can only save host and panelist chats.\n* `2` - Attendees can save all chats.","example":0,"enum":[0,1,2]},"default_attendees_chat_with":{"type":"integer","description":"By default, allow webinar attendees to chat with.\n* `1` - Host and all panelists.\n* `2` - Everyone.","example":1,"enum":[1,2]},"enable":{"type":"boolean","description":"Whether to allow webinar participants to send chat messages.","example":true}}},"webinar_live_streaming":{"type":"object","properties":{"custom_service_instructions":{"type":"string","description":"The specific instructions to allow your account's meeting hosts to configure a custom livestream.","example":"The specific instructions test"},"enable":{"type":"boolean","description":"Whether webinar livestreaming is enabled.","example":true},"live_streaming_reminder":{"type":"boolean","description":"Whether to notify users to watch the livestream. This does not apply to custom real-time messaging protocol (RTMP).","example":true},"live_streaming_service":{"type":"array","description":"The available livestreaming services.\n* `facebook`\n* `workplace_by_facebook`\n* `youtube`\n* `custom_live_streaming_service`","items":{"type":"string","example":"facebook","enum":["facebook","workplace_by_facebook","youtube","custom_live_streaming_service"],"x-enum-descriptions":["Facebook","Workplace by Facebook","YouTube","Custom Live Streaming Service"]}}}},"meeting_polling":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow the host to add polls before or during a meeting.","example":true},"advanced_polls":{"type":"boolean","description":"Whether to allow the host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. Hosts can also set the correct answers for quizzes they create.","example":true},"manage_saved_polls_and_quizzes":{"type":"boolean","description":"Whether to allow users to manage saved polls and quizzes from Meetings","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow the host to upload an image for each question.","example":true}},"description":"Information about the account's meeting polling settings."},"webinar_polling":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow the host to add polls before or during a webinar.","example":true},"advanced_polls":{"type":"boolean","description":"Whether to allow the host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. Hosts can also set the correct answers for quizzes they create.","example":true},"manage_saved_polls_and_quizzes":{"type":"boolean","description":"Whether to allow users to manage saved polls and quizzes from Meetings","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow the host to upload an image for each question.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true}}},"webinar_question_answer":{"type":"boolean","description":"Whether attendees can ask the host and panelists questions in the webinar.","example":true},"webinar_survey":{"type":"boolean","description":"Whether to allow the host to present surveys to attendees once a webinar has ended.","example":true},"whiteboard":{"type":"boolean","description":"Allow participants to share a whiteboard that includes annotation tools.","example":true},"who_can_share_screen":{"type":"string","description":"Indicates who can share their screen or content during meetings. The value can be one of the following: \n \n`host`: Only host can share the screen. \n \n`all`: Both hosts and attendees can share their screen during meetings. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"host","enum":["host","all"]},"who_can_share_screen_when_someone_is_sharing":{"type":"string","description":"Indicates who is allowed to start sharing screen when someone else in the meeting is sharing their screen. The value can be one of the following: \n \n`host`: Only a host can share the screen when someone else is sharing. \n \n`all`: Anyone in the meeting is allowed to start sharing their screen when someone else is sharing. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"all","enum":["host","all"]},"participants_share_simultaneously":{"type":"string","description":"Indicates how many participants can share at the same time. The value can be one of the following: \n \n`one`: Only one participant can share at a time\n. \n \n`multiple`: Multiple participants can share simultaneously (dual monitors recommended)\n. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"multiple","enum":["multiple","one"]},"workplace_by_facebook":{"type":"boolean","description":"Whether Workplace by Facebook is enabled.","example":true}}},"other_options":{"type":"object","properties":{"allow_users_contact_support_via_chat":{"type":"boolean","description":"Whether to display the Zoom help badge on the bottom-right of the page.","example":true},"blur_snapshot":{"type":"boolean","description":"Whether iOS blurs the screenshot in the task switcher when multiple apps are open. Android hides the screenshot in the system-level list of recent apps.","example":true},"webinar_registration_options":{"type":"object","properties":{"allow_host_to_enable_join_info":{"type":"boolean","description":"Allow host to enable **Show join info on registration confirmation page**.","example":true},"allow_host_to_enable_social_share_buttons":{"type":"boolean","description":"Allow host to enable **Show social share buttons on registration page**.","example":true},"enable_custom_questions":{"type":"boolean","description":"Enable custom questions.","example":true}},"description":"Webinar registration options."}}},"profile":{"title":"Profile","type":"object","properties":{"recording_storage_location":{"type":"object","properties":{"allowed_values":{"type":"array","description":"Users can choose the country to store their recorded content. Content can include meeting, webinar, and phone recordings, as well as voicemail, transcripts, and custom greeting prompts. See [Managing the Communications Content storage location](https://support.zoom.us/hc/en-us/articles/360050781131) for details.\n\nProvide abbreviated country codes as the value for this field. See the [Countries abbreviation list](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) for details.","items":{"type":"string","example":"US"}},"value":{"type":"string","description":"Abbreviated country code.","example":"US"}}}}},"recording":{"type":"object","properties":{"account_user_access_recording":{"type":"boolean","description":"Make cloud recordings accessible to account members only.","example":true},"archive":{"type":"object","properties":{"enable":{"type":"boolean","description":"Enable the archiving feature.","example":true},"settings":{"type":"object","properties":{"audio_file":{"type":"boolean","description":"Include in-meeting or in-webinar audio in the archive.","example":true},"cc_transcript_file":{"type":"boolean","description":"Include closed caption or transcript in the archive.","example":true},"chat_file":{"type":"boolean","description":"Include in-meeting chat in the archive.","example":true},"chat_with_sender_email":{"type":"boolean","description":"Include user email in in-meeting chat file.","example":true},"video_file":{"type":"boolean","description":"Include in-meeting or in-webinar video in the archive.","example":true},"chat_with_direct_message":{"type":"boolean","description":"Include direct message in in-meeting chat file.","example":true},"archive_retention":{"type":"integer","description":"The retention period for archiving content, in days.","example":1,"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30]},"action_when_archive_failed":{"type":"integer","description":"Perform the action when meetings or webinars cannot be archived. \n `1` - Participants can stay in the meeting and will receive a notification. \n `2` - Nobody can join or stay in the meeting.","example":1,"enum":[1,2]},"notification_when_archiving_starts":{"type":"string","description":"Show notification when video or audio archiving starts. \n `1` - Participants can stay in the meeting and will receive a notification. \n `2` - Nobody can join or stay in the meeting.","example":"participants","enum":["participants","guest"]},"play_voice_prompt_when_archiving_starts":{"type":"string","description":"Play voice prompt when video or audio archiving starts. \n `1` - Participants can stay in the meeting and will receive a notification. \n `2` - Nobody can join or stay in the meeting.","example":"guest","enum":["participants","guest","none"]}}},"type":{"type":"integer","description":"Archive types.\n\n* `1` - Only meetings are archived. \n \n* `2` - Only webinars are archived. \n \n* `3` - Both meetings and webinars are archived.","example":2,"enum":[1,2,3]}},"description":"[Archiving solution](https://support.zoom.us/hc/en-us/articles/360050431572-Archiving-Meeting-and-Webinar-data) settings. This setting can only be used if you have been granted archiving solution access by the Zoom Support team."},"auto_recording":{"type":"string","description":"Record meetings automatically as they start.","example":"local"},"cloud_recording":{"type":"boolean","description":"Allow hosts to record and save the meeting or webinar in the cloud.","example":true},"cloud_recording_download":{"type":"boolean","description":"Allow anyone with a link to the cloud recording to download.","example":true},"cloud_recording_download_host":{"type":"boolean","description":"Allow only the host with a link to the cloud recording to download.","example":true},"host_delete_cloud_recording":{"type":"boolean","description":"Allow the host to delete the recordings. If this option is disabled, the recordings cannot be deleted by the host and only admin can delete them.","example":true},"record_files_separately":{"type":"object","properties":{"active_speaker":{"type":"boolean","description":"Whether recording only the active speaker is enabled.","example":true},"gallery_view":{"type":"boolean","description":"Whether recording only the gallery view is enabled.","example":true},"shared_screen":{"type":"boolean","description":"Whether recording only shared screen is enabled.","example":true}},"description":"The account's [**Record active speaker, gallery view and shared screen separately**](https://support.zoom.us/hc/en-us/articles/360060316092-Changing-basic-and-advanced-cloud-recording-settings#h_01F4CYJTCTXNS2MXH00W9EFG6R) settings."},"display_participant_name":{"type":"boolean","description":"Whether participants' names display in the recording.","example":true},"recording_thumbnails":{"type":"boolean","description":"Whether thumbnails of the presenter are recorded when they are sharing their screen.","example":true},"optimize_recording_for_3rd_party_video_editor":{"type":"boolean","description":"Whether recordings will be optimized for a 3rd party video editor. This can increase the file size and the time it takes to generate recording files.","example":true},"recording_highlight":{"type":"boolean","description":"Whether the [recording highlights](https://support.zoom.us/hc/en-us/articles/360060802432) feature is enabled.","example":true},"save_panelist_chat":{"type":"boolean","description":"Whether panelist chats are saved to the recording.","example":true},"save_poll_results":{"type":"boolean","description":"Whether poll results shared during the meeting or webinar are saved. This also includes poll results shared during the meeting or webinar.","example":true},"save_close_caption":{"type":"boolean","description":"Whether [closed captions](https://support.zoom.us/hc/en-us/articles/207279736) are saved as a VTT (Video Track Text) file.","example":true},"ip_address_access_control":{"type":"object","properties":{"enable":{"type":"boolean","description":"If set to `true`, the cloud recordings of this account can only be accessed by the IP addresses defined in the `ip_addresses_or_ranges` property.\n\n","example":true},"ip_addresses_or_ranges":{"type":"string","description":"IP addresses or ranges that have access to the cloud recordings. Separate multiple IP ranges with comma. Use n.n.n.n, n.n.n.n/n or n.n.n.n - n.n.n.n syntax where n is a number.\n\nExample: `46.33.24.184, 48.99.100.2/25` or `200.181.108.17 - 220.181.108.157`\n\n","example":"200.181.108.17 - 220.181.108.157"}},"description":"Setting to allow cloud recording access only from specific IP address ranges.\n"},"local_recording":{"type":"boolean","description":"Allow hosts and participants to record the meeting to a local file.","example":true},"prevent_host_access_recording":{"type":"boolean","description":"If set to `true`, meeting hosts cannot view their meeting cloud recordings. Only the admins who have recording management privilege can access them.\n\n","example":true},"record_audio_file":{"type":"boolean","description":"Whether to record one audio file for all participants.","example":true},"record_gallery_view":{"type":"boolean","description":"When someone is sharing their screen, active speaker will show on the top right corner of the shared screen.","example":true},"record_speaker_view":{"type":"boolean","description":"Record active speaker with shared screen.","example":true},"recording_audio_transcript":{"type":"boolean","description":"Automatically transcribe the audio of a meeting or webinar for cloud recordings.","example":true},"smart_recording":{"type":"object","properties":{"create_recording_highlights":{"type":"boolean","description":"By selecting this option, meeting details in the audio transcript will be highlighted. Hosts can modify highlighted sections and generate a video summary (highlighted sections may have a 3-second offset) based on these sections. The summary is for informational purposes only and may not be complete.","example":true},"create_smart_chapters":{"type":"boolean","description":"By selecting this option, your recording will have chapters with overview. Hosts can edit the chapters.","example":true},"create_next_steps":{"type":"boolean","description":"By selecting this option, there will be a summary of actions to take after the recorded meeting.","example":true}},"description":"By selecting this option, your recording will have meeting smart chapters, and next steps. You are directing Zoom to access, process, and use your account's recording data for the purpose of analysis and insights."},"save_chat_text":{"type":"boolean","description":"Save chat messages from the meeting or webinar.","example":true},"show_timestamp":{"type":"boolean","description":"Add a timestamp to the recording.","example":true},"recording_notification_for_zoom_client":{"type":"object","properties":{"disclaimer_to_participants":{"type":"string","description":"Child setting name is [Show a disclaimer to participants when a recording starts], the value is option name you selected.","example":"All participants or Guest only"},"play_voice_prompt":{"type":"string","description":"Child setting name is [Play voice prompt for], the value is option name you selected.","example":" All participants or Guest only or No one"},"ask_host_to_confirm":{"type":"boolean","description":"Child setting name is [Ask host to confirm before starting a recording], the value is option name you selected","example":true}},"description":"setting name: Recording notifications - Zoom clients"},"durable_meeting_transcript":{"type":"object","properties":{"durable_meeting_transcript":{"type":"boolean","description":"Main setting value","example":true},"allow_host_access_meeting_transcript":{"type":"boolean","description":"Allow hosts to access and manage transcripts","example":true}},"description":"Allow users to retain, access,and manage transcripts generated by AI Companion features for use by other AI Companion services."},"allow_revenue_accelerator_manage_recording_separate_auto_delete":{"type":"boolean","description":"Allow Zoom Revenue Accelerator to manage recording files with separate auto-delete settings","example":true},"cloud_recording_permanently_deleted":{"type":"object","properties":{"cloud_recording_permanently_deleted_from_trash":{"type":"boolean","description":"Main setting value","example":true},"email_reminder_type":{"type":"string","description":"Selected email reminder","example":"Weekly digest on Monday","enum":["7 days before deletion","Weekly digest on Monday"]}},"description":"When the cloud recording is going to be permanently deleted from trash"},"allow_cmr_3rd_party_bot":{"type":"boolean","description":"Allow 3rd-party recording","example":true},"water_marker_recording":{"type":"boolean","description":"add water marker for recording","example":true},"viewer_see_transcript":{"type":"boolean","description":"Viewers can see the transcript","example":true},"allow_invitees_access_recordings_without_passcode":{"type":"boolean","description":"Allow invitees to access recordings without the passcode","example":true},"recording_as_on_demand":{"type":"boolean","description":"Set recording as on-demand by default","example":true},"recording_notifications_phone_users":{"type":"object","properties":{"require_press_one_consent_to_record":{"type":"boolean","description":"Require phone-only users to press 1 to consent to being recorded","example":true},"multiple_notifications_phone_users":{"type":"boolean","description":"Multiple notifications for phone users","example":true}},"description":"Recording notifications - Phone users"},"upload_recording":{"type":"boolean","description":"Upload recording to the cloud","example":true},"allow_add_cloud_recordings_to_zoom_clips":{"type":"boolean","description":"Allow users to add cloud recordings to Zoom Clips","example":true},"allow_share":{"type":"boolean","description":"Allow cloud recording sharing","example":true},"viewer_see_chat":{"type":"boolean","description":"Viewers see chat","example":true},"authenticated_view_cloud_recoding":{"type":"object","properties":{"authenticated_can_view_cloud_recordings":{"type":"boolean","description":"Main setting value","example":true},"default_authenticate_content":{"type":"string","description":"Default authentication option","example":"Signed-in users in my account","enum":["Signed-in users in my account","Sign in to Zoom","Sign in to Zoom with specified domains","Sign in to external Single Sign-On (SSO)","Only people with access"]}},"description":"Require users to authenticate before viewing cloud recordings"},"notification_subscription_url_when_recording_available":{"type":"boolean","description":"Push notification to subscription URL when a cloud recording is available","example":true},"recording_storage_email_notifications":{"type":"boolean","description":"Recording storage email notifications","example":true},"local_recording_options":{"type":"object","properties":{"internal_meeting_participants":{"type":"boolean","description":"Internal meeting participants","example":true},"internal_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"external_meeting_participants":{"type":"boolean","description":"External meeting participants","example":true},"external_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"participants_with_specified_domains":{"type":"boolean","description":"Meeting participants with specified domains","example":true},"participants_with_specified_domains_content":{"type":"string","description":"Enter the domain information","example":"zoom.us"},"participants_specified_domains_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"save_chat_messages":{"type":"boolean","description":"Save chat messages from the meeting / webinar","example":true},"save_closed_caption":{"type":"boolean","description":"Save closed caption as a VTT file","example":true}},"description":"all sub-options for local recording"},"embed_passcode_in_shareable_link":{"type":"boolean","description":"Embed passcode in the shareable link for one-click access","example":true}}},"schedule_meeting":{"type":"object","properties":{"audio_type":{"type":"string","description":"Determine how participants can join the audio portion of the meeting.","example":"both"},"embed_password_in_join_link":{"type":"boolean","description":"If the value is set to `true`, the meeting passcode will be encrypted and included in the join meeting link to allow participants to join with just one click without having to enter the passcode.\n ","example":true},"force_pmi_jbh_password":{"type":"boolean","description":"If join before host option is enabled for a personal meeting, then enforce passcode requirement.\n\n\n**This field will be deprecated in near future.** If you would like to enable this setting, we highly encourage you to use the `require_password_for_pmi_meetings` field.\n\n","example":true,"deprecated":true},"host_video":{"type":"boolean","description":"Start meetings with host video on.","example":true},"join_before_host":{"type":"boolean","description":"Allow participants to join the meeting before the host arrives.","example":true},"mute_upon_entry":{"type":"boolean","description":"Automatically mute all participants when they join the meeting.","example":true},"participant_video":{"type":"boolean","description":"Start meetings with participant video on.","example":true},"personal_meeting":{"type":"boolean","description":"Personal meeting setting. \n n \n`true` - Indicates that the **Enable Personal Meeting ID** setting is turned on. Users can choose to use personal meeting ID for their meetings. \n \n \n`false` - Indicates that the **Enable Personal Meeting ID** setting is [turned off](https://support.zoom.us/hc/en-us/articles/201362843-Personal-meeting-ID-PMI-and-personal-link#h_aa0335c8-3b06-41bc-bc1f-a8b84ef17f2a). If this setting is disabled, meetings that were scheduled with PMI will be invalid. Scheduled meetings will need to be manually updated.\nFor Zoom Phone only:If a user has been assigned a desk phone, **Elevate to Zoom Meeting** on desk phone will be disabled.\n\n\n","example":true},"pstn_password_protected":{"type":"boolean","description":"Generate and send new passcodes for newly scheduled or edited meetings.","example":true},"require_password_for_instant_meetings":{"type":"boolean","description":"If enabled, a random passcode will be generated on the user's end who starts the instant meeting. Other participants will have to enter the password to join the meeting. If you use PMI for your instant meetings, this option will be disabled.","example":true},"require_password_for_pmi_meetings":{"type":"string","description":"Indicates whether a passcode is required for [PMI](https://support.zoom.us/hc/en-us/articles/203276937-Using-Personal-Meeting-ID-PMI-) meetings or not. \n \n`none` - Do not require password for PMI meetings. \n \n`all` - Require participants to enter password for all PMI enabled meetings. \n `jbh_only` - Require password only for meetings where the **join before host** setting is enabled.","example":"jbh_only","enum":["all","jbh_only","none"]},"require_password_for_scheduled_meetings":{"type":"boolean","description":"Require a passcode for meetings which have already been scheduled\n","example":true},"require_password_for_scheduling_new_meetings":{"type":"boolean","description":"This setting applies for regular meetings that do not use a PMI. If enabled, a password will be generated while a host schedules a new meeting and participants will be required to enter the password before they can join the meeting.","example":true},"upcoming_meeting_reminder":{"type":"boolean","description":"Receive desktop notification for upcoming meetings.","example":true},"use_pmi_for_instant_meetings":{"type":"boolean","description":"Indicates whether PMI is enabled for all instant meetings or not.","example":true},"use_pmi_for_schedule_meetings":{"type":"boolean","description":"Indicates whether PMI is enabled for all scheduled meetings or not.","example":true},"always_display_zoom_meeting_as_topic":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the **Always display `Zoom Meeting` as the meeting topic** setting is enabled.","example":false},"display_topic_for_scheduled_meetings":{"type":"boolean","description":"Whether to display **Zoom Meeting** as the topic for already-scheduled meetings.","example":false}},"description":"Information about the [**Always display `Zoom Meeting` as the meeting topic**](https://support.zoom.us/hc/en-us/articles/201363253-Changing-account-settings#h_01EG9BJ646V2WJK1S3H2MP6YV6) setting."},"always_display_zoom_webinar_as_topic":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the **Always show `Zoom Webinar` as the webinar topic** setting is enabled.","example":false},"display_topic_for_scheduled_webinars":{"type":"boolean","description":"Whether to display **Zoom Webinar** as the topic for already-scheduled meetings.","example":false}},"description":"Information about the [**Always show `Zoom Webinar` as the webinar topic**](https://support.zoom.us/hc/en-us/articles/201363253-Changing-account-settings#h_01EG9BJ646V2WJK1S3H2MP6YV6) setting."},"continuous_meeting_chat":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable the **Enable continuous meeting chat** setting.","example":true},"can_add_external_users":{"type":"boolean","description":"Whether to enable the **External users can be added** setting.","example":true},"auto_add_invited_external_users":{"type":"boolean","description":"Whether to enable the **Automatically add invited external users** setting.","example":true}},"description":"Information about the **Enable continuous meeting chat** feature."}}},"telephony":{"type":"object","properties":{"audio_conference_info":{"type":"string","description":"Third party audio conference info.","example":"test"},"telephony_regions":{"type":"object","properties":{"selection_values":{"type":"string","description":"The account's selected telephony regions that indicate where most participants call into or call from during a meeting.","example":"CNTB"}},"description":"Indicates where most of the participants call into or call from during a meeting."},"third_party_audio":{"type":"boolean","description":"Allow users to join the meeting using the existing 3rd party audio configuration.","example":true}},"description":"Group Settings: Telephony."},"chat":{"type":"object","properties":{"share_files":{"type":"object","properties":{"enable":{"type":"boolean","description":"Allow users of this account to send and receive files in chats and channels. When disabled, users can still take and share screenshots.","example":true},"share_option":{"type":"string","description":"Allow users of this account to send and receive files in chats and channels. When disabled, users can still take and share screenshots.","example":"true","enum":["anyone","account","organization"],"x-enum-descriptions":["Anyone (internal and external contacts)","In the same account","In the same organization"]}},"description":"Users can share files in chats and channels."},"chat_emojis":{"type":"object","properties":{"enable":{"type":"boolean","description":"Allow users to use the emoji library in direct messages or group conversations. Choose between allowing users to use any emoji in the library, or choose to allow only pre-selected emojis. If the setting is disabled, users can still use keyboard shortcuts to add emojis. Users can change their emoji skin tone in Settings.","example":true},"emojis_option":{"type":"string","example":"all","enum":["all","selected"],"x-enum-descriptions":["All emojis","Selected emojis"]}},"description":"Chat emojis."},"record_voice_messages":{"type":"boolean","description":"Allow users to record voice messages that can be sent in direct messages or group conversations.","example":true},"record_video_messages":{"type":"boolean","description":"Allow users to record video messages that can be sent in direct messages or group conversations. If the file share setting is disabled, they will not be able to record and send video messages.","example":true},"screen_capture":{"type":"boolean","description":"Allow users to take and send screenshots in direct messages or group conversations.","example":true},"create_public_channels":{"type":"boolean","description":"Allow users to create public channels.","example":true},"create_private_channels":{"type":"boolean","description":"Allow users to create private channels.","example":true},"share_links_in_chat":{"type":"boolean","description":"Share links to messages and channels in Team Chat.","example":true},"schedule_meetings_in_chat":{"type":"boolean","description":"Schedule a meeting from chat or channel.","example":true},"set_retention_period_in_cloud":{"type":"object","properties":{"enable":{"type":"boolean","description":"By default, messages and files are stored in Zoom's cloud. Enable this setting to specify when they are deleted. When retention is disabled, messages sent by offline users can be received within 7 days before they are deleted.","example":true},"retention_period_of_direct_messages_and_group_conversation":{"type":"string","description":"Delete direct messages and group conversations after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"},"retention_period_of_channels":{"type":"string","description":"Delete data in channels after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"}},"description":"Set retention period for messages and files in Zoom's cloud."},"set_retention_period_in_local":{"type":"object","properties":{"enable":{"type":"boolean","description":"Specify how long your messages are saved on local devices. If this setting is disabled, messages are never deleted locally.","example":true},"retention_period_of_direct_messages_and_group_conversation":{"type":"string","description":"Delete direct messages and group conversations after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"},"retention_period_of_channels":{"type":"string","description":"Delete data in channels after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"}},"description":"Store messages on local devices, excluding personal channel messages."},"allow_users_to_search_others_options":{"type":"string","description":"Allow users to search others, when selecting multiple items, separate them with commas. \n* ''-none. \n* '1' - In the same account. \n* '2' - Under the same master account, including all sub acounts. \n* '3' - Under the same organization.","example":"1,3"},"allow_users_to_add_contacts":{"type":"object","properties":{"enable":{"type":"boolean","description":"By disabling this setting, users will not be able to add contacts.","example":true},"selected_option":{"type":"integer","description":"The type of allowing users to add contacts. \n* 1 - Anyone, either internal and external contacts. \n* 2 - In the same organization. \n* 3 - In the same organization and specified domains. \n* 4 - In the same organization and specified users.","example":4,"enum":[1,2,3,4]},"user_email_addresses":{"type":"string","description":"The domains or emails, internal or external. \n* When the `selected_option` field value is `3`, the value is internal or external domains. Use a comma to separate multiple domains.\n* When the `selected_option` field value is `4`, the value is internal or external email addresses. Use a comma to separate multiple emails.","example":"123@test.com"}},"description":"Allow users to add contacts."},"allow_users_to_chat_with_others":{"type":"object","properties":{"enable":{"type":"boolean","description":"If you select 'In the same organization', users may still be able to chat with external users if they are added to channels or group chats with external users.","example":true},"selected_option":{"type":"integer","description":"The type of allowing users to add contacts. \n* 1 - Anyone (internal and external contacts). \n* 2 - In the same organization. \n* 3 - In the same organization and specified domains. \n* 4 - In the same organization and specified users.","example":4,"enum":[1,2,3,4]},"user_email_addresses":{"type":"string","description":"The domains or emails, either internal or external. \n* When the `selected_option` field value is `3`, the value is internal or external domains. Use a comma to separate multiple domains.\n* When the `selected_option` field value is `4`, the value is internal or external email addresses. Use a comma to separate multiple emails.","example":"123@test.com"}},"description":"Allow users to chat with others."},"chat_etiquette_tool":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the **Chat Etiquette Tool** is enabled.","example":true},"policies":{"type":"array","description":"Information about the defined **Chat Etiquette Tool** policies.","items":{"type":"object","properties":{"description":{"type":"string","description":"The policy's description.","example":"The policy's description"},"id":{"type":"string","description":"The policy ID.","example":"dvgerwe98z8v9vgbug43iubkjn"},"is_locked":{"type":"boolean","description":"Whether the policy is locked by an account-level user. When it is locked, users cannot update the policy.","example":true},"keywords":{"type":"array","description":"A list of defined rule keywords.","items":{"type":"string","example":"key"}},"name":{"type":"string","description":"The policy name.","example":"The policy name"},"regular_expression":{"type":"string","description":"The regular expression to match to the content of chat messages.","example":"^test"},"status":{"type":"string","description":"The policy's current status. \n* `activated` - Activated. \n* `deactivated` - Deactivated.","example":"Activated","enum":["activated","deactivated"],"x-enum-descriptions":["Activated.","Deactivated."]},"trigger_action":{"type":"integer","description":"The policy's trigger action. \n* `1` - Ask the user to confirm before they send the message. \n* `2` - Block the user's message.","example":2,"enum":[1,2],"x-enum-descriptions":["Ask the user to confirm before they send the message.","Block the user's message."]}}}}},"description":"Information about the Chat Etiquette tool."},"send_data_to_third_party_archiving_service":{"type":"object","properties":{"enable":{"type":"boolean","description":"Allow users to send data to third-party archiving service.","example":true}},"description":"Send data to third-party archiving service."},"translate_messages":{"type":"boolean","description":"Allow users to translate team chat messages. [Learn more].(https://support.zoom.us/hc/en-us/articles/12998089084685)","example":true},"search_and_send_animated_gif_images":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow users to search GIF images from GIPHY when they compose messages.","example":true}},"description":"Allow users to search GIF images from GIPHY when they compose messages. See GIPHY's website for more information about content ratings."}},"description":"The account's chat settings."},"mail_calendar":{"type":"object","properties":{"email_calendar_management":{"type":"boolean","description":"Allow the Zoom client to manage both emails and calendar events for the user.","example":true},"email_management":{"type":"boolean","description":"Allow the Zoom client to manage user emails.","example":true},"zoom_email_provider":{"type":"boolean","description":"Allow users to select Zoom as their email service provider.","example":true}},"description":"Email and calendar related settings."},"general_setting":{"title":"General settings.","type":"object","properties":{"auto_zoom_room_proximity_connect":{"type":"boolean","description":"Allow automatic direct sharing and connecting to Zoom Rooms using ultrasonic proximity signal.","example":true}},"description":"General settings."}}},{"oneOf":[{"type":"object","properties":{"allow_authentication_exception":{"type":"boolean","description":"Whether the [**Allow authentication exception**](https://support.zoom.us/hc/en-us/articles/360037117472#h_01F13A9N1FQFNVESC9C21NRHXY) setting is enabled. This lets hosts invite users who can bypass authentication.","example":true},"authentication_options":{"type":"array","description":"Meeting Authentication Options","items":{"type":"object","properties":{"default_option":{"type":"boolean","description":"Authentication default option","example":true},"domains":{"type":"string","description":"Authentication domains","example":"example.com"},"id":{"type":"string","description":"Authentication id","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"Authentication name","example":"Authentication name"},"type":{"type":"string","description":" Authentication type. Specify one of the following authentication types for the authentication profile: \n \n * `enforce_login`: This option allows any users to join the meeting or webinar, as long as they are signed into their Zoom account.\n * `enforce_login_with_domains`: This option, allows you to specify a rule so that only those Zoom users whose email addresses contain a certain domain, can join the meeting or webinar. You can either add multiple domains using a comma in between and/or use a wildcard for listing domains. \n \n * `enforce_login_with_same_account`: This option allows users to join the meeting or webinar with the same Zoom account.","example":"enforce_login_with_domains","enum":["enforce_login","enforce_login_with_same_account","enforce_login_with_domains"]},"visible":{"type":"boolean","description":"Authentication visible","example":true}}}},"meeting_authentication":{"type":"boolean","description":"Only authenticated users can join meetings","example":true}}},{"type":"object","properties":{"authentication_options":{"type":"array","description":"Authentication Options","items":{"type":"object","properties":{"default_option":{"type":"boolean","description":"Authentication default option","example":true},"domains":{"type":"string","description":"Authentication domains","example":"example.com"},"id":{"type":"string","description":"Authentication id","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"Authentication name","example":"Authentication name"},"type":{"type":"string","description":"Authentication type","example":"enforce_login_with_domains","enum":["internally","enforce_login","enforce_login_with_domains"]},"visible":{"type":"boolean","description":"Authentication visible","example":true}}}},"recording_authentication":{"type":"boolean","description":"Only authenticated users can view cloud recordings","example":true}}}]},{"title":"Meeting/Webinar Security Group Settings","type":"object","properties":{"meeting_security":{"type":"object","properties":{"auto_security":{"type":"boolean","description":"Whether all meetings are required to be secured with at least one security option. \n\n This setting can only be disabled by Enterprise, ISV, Business (with more than 100 licenses), and Education accounts.","example":true},"block_user_domain":{"type":"boolean","description":"Whether users in specific domains are blocked from joining meetings and webinars.","example":true},"block_user_domain_list":{"maxItems":20,"type":"array","description":"A list of blocked domains.","items":{"maxLength":30,"minLength":5,"type":"string","example":"example.com"}},"chat_etiquette_tool":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the **Chat Etiquette Tool** is enabled.","example":true},"policies":{"type":"array","description":"Information about the defined **Chat Etiquette Tool** policies.","items":{"type":"object","properties":{"description":{"type":"string","description":"The policy's description.","example":"The policy's description"},"id":{"type":"string","description":"The policy ID.","example":"dvgerwe98z8v9vgbug43iubkjn"},"is_locked":{"type":"boolean","description":"Whether the policy is locked by an account-level user. When it is locked, users cannot update the policy.","example":true},"keywords":{"type":"array","description":"A list of defined rule keywords.","items":{"type":"string","example":"key"}},"name":{"type":"string","description":"The policy name.","example":"The policy name"},"regular_expression":{"type":"string","description":"The regular expression to match to the content of chat messages.","example":"^test"},"status":{"type":"string","description":"The policy's current status. \n* `activated` - Activated. \n* `deactivated` - Deactivated.","example":"Activated","enum":["activated","deactivated"],"x-enum-descriptions":["Activated.","Deactivated."]},"trigger_action":{"type":"integer","description":"The policy's trigger action. \n* `1` - Ask the user to confirm before they send the message. \n* `2` - Block the user's message.","example":2,"enum":[1,2],"x-enum-descriptions":["Ask the user to confirm before they send the message.","Block the user's message."]}}}}},"description":"Information about the Chat Etiquette Tool."},"embed_password_in_join_link":{"type":"boolean","description":"Whether the meeting password will be encrypted and included in the invitation link. The provided link will allow participants to join the meeting without having to enter the password.","example":true},"encryption_type":{"type":"string","description":"The type of encryption used to start a meeting. \n* `enhanced_encryption` - Enhanced encryption. Encryption data is stored in the cloud. \n* `e2ee` - End-to-end encryption. The encryption key is stored on the local device and cannot be obtained by anyone else. E2EE also [**disables** certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":"enhanced_encryption","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Whether end-to-end encryption is enabled for meetings.","example":true},"meeting_password":{"type":"boolean","description":"Whether all instant and scheduled meetings that users can join via client or Zoom Rooms systems are password-protected. [Personal meeting ID (PMI)](https://support.zoom.us/hc/en-us/articles/203276937) meetings are **not** included in this setting.","example":true},"meeting_password_requirement":{"type":"object","properties":{"consecutive_characters_length":{"type":"integer","description":"The maximum length of consecutive characters, like `abcdef`, allowed in a password. \n* `4` through `8` - The maximum consecutive characters length. The length is `n` minus `1`, where `n` is the provided value. For example, if you provide the `4` value, there can only be a maximum of `3` consecutive characters in a password (for example, `abc1x@8fdh`). \n* `0` - Do not apply a consecutive character restriction.","example":8,"enum":[0,4,5,6,7,8]},"have_letter":{"type":"boolean","description":"Whether the password must contain at least one letter character.","example":true},"have_number":{"type":"boolean","description":"Whether the password must contain at least one numeric character.","example":true},"have_special_character":{"type":"boolean","description":"Whether the password must contain at least one special character. For example, `!`, `@`, and/or `#` characters.","example":true},"have_upper_and_lower_characters":{"type":"boolean","description":"Whether the password must include uppercase and lowercase characters.","example":true},"length":{"type":"integer","description":"The password's minimum length.","example":10},"only_allow_numeric":{"type":"boolean","description":"Whether the password must contain **only** numeric characters.","example":true},"weak_enhance_detection":{"type":"boolean","description":"Whether users will be informed when the provided password is weak.","example":true}},"description":"Information about the meeting and webinar [password requirements](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604)."},"only_authenticated_can_join_from_webclient":{"type":"boolean","description":"Whether to specify that only authenticated users can join the meeting from the web client.","example":true},"phone_password":{"type":"boolean","description":"Whether a password is required for participants joining by phone. \n\n If enabled and the meeting is password-protected, a numeric password is required for participants to join by phone. For meetings with alphanumeric passwords, a numeric password will be generated.","example":true},"pmi_password":{"type":"boolean","description":"Whether all Personal Meeting ID (PMI) meetings that users can join via client or Zoom Rooms systems are password-protected.","example":true},"require_password_for_scheduled_meeting":{"type":"boolean","description":"Whether a password is required for meetings that have already been scheduled.","example":true},"require_password_for_scheduled_webinar":{"type":"boolean","description":"Whether a password is required for webinars that have already been scheduled.","example":true},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting. \n\n When the **Waiting Room** feature is enabled, the [**Allow participants to join before host**](https://support.zoom.us/hc/en-us/articles/202828525-Allow-participants-to-join-before-host) setting is disabled.","example":true},"waiting_room_settings":{"type":"object","properties":{"participants_to_place_in_waiting_room":{"type":"integer","description":"The type of participants to be admitted to the waiting room. \n* `0` - All attendees. \n* `1` - Users who are not in your account. \n* `2` - Users who are not in your account and are not part of your [allowed domains list](https://support.zoom.us/hc/en-us/articles/360037117472-Configuring-authentication-profiles#h_e3cf0d5f-eec7-4c2a-ad29-ef2a5079a7da).","example":0,"enum":[0,1,2]},"users_who_can_admit_participants_from_waiting_room":{"type":"integer","description":"The users who can admit participants from the waiting room. \n* `0` - Host and co-hosts only. \n* `1` - Host, co-hosts, and anyone who bypassed the Waiting Room if the host and co-hosts are not present.","example":1,"enum":[0,1]},"whitelisted_domains_for_waiting_room":{"type":"string","description":"If the `participants_to_place_in_waiting_room` field is `2`, a comma-separated list of the domains that can bypass the waiting room (`example.com,example2.com`).","example":"example.com"}},"description":"Information about the waiting room settings."},"webinar_password":{"type":"boolean","description":"Whether a password is generated when scheduling webinars. Participants must use the generated password to join the scheduled webinar.","example":true}}}},"description":"The group's meeting and webinar security settings."}]}}}},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n Group does not exist: {groupId}.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:settings:admin"]}},"patch":{"tags":["Groups"],"summary":"Update a group's settings","description":"Update settings for a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-). \n\n **Note:**\n The `force_pmi_jbh_password` field under meeting settings is deprecated as of September 22, 2019. \n\n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:update:settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateGroupSettings","parameters":[{"name":"groupId","in":"path","description":"The group's ID.","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}},{"name":"option","in":"query","description":"Optional query parameters. \n* `meeting_authentication` - [Meeting authentication settings](https://support.zoom.us/hc/en-us/articles/360037117472-Authentication-Profiles-for-Meetings-and-Webinars). \n* `recording_authentication` - [Recording authentication settings](https://support.zoom.us/hc/en-us/articles/360037756671-Authentication-Profiles-for-Cloud-Recordings). \n* `meeting_security` - Meeting security settings.","required":false,"schema":{"type":"string","example":"meeting_security","enum":["meeting_authentication","recording_authentication","meeting_security"]}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"audio_conferencing":{"type":"object","properties":{"toll_free_and_fee_based_toll_call":{"type":"object","properties":{"allow_webinar_attendees_dial":{"type":"boolean","description":"Whether webinar attendees can dial in through the account's **Toll-free and Fee-based Toll Call** phone numbers. This feature is only available in version 5.2.2 and higher.","example":true},"enable":{"type":"boolean","description":"Whether the group has the [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call#h_01F51844DRCX3K7BRTMZ40381R) setting enabled.","example":true},"numbers":{"maxItems":100,"type":"array","description":"The group's **Toll-free and Fee-based Toll Call** phone number information.","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's [E.164 country calling code](https://en.wikipedia.org/wiki/List_of_country_calling_codes).","example":"86"},"country_code":{"type":"string","description":"The phone number's [country code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries).","example":"CN"},"country_name":{"type":"string","description":"The country name.","example":"China"},"display_number":{"maxLength":30,"type":"string","description":"The phone number's display number.","example":"+86 7777 777"},"number":{"maxLength":30,"type":"string","description":"The phone number.","example":"7777 777"}}}}},"description":"The group's [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call#h_01F51844DRCX3K7BRTMZ40381R) settings."},"toll_call":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the group has the [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F51680NJ7YHZDXGJNSKDGM2P) setting enabled.","example":true},"numbers":{"maxItems":100,"type":"array","description":"The group's **Toll Call** phone number information.","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's [E.164 country calling code](https://en.wikipedia.org/wiki/List_of_country_calling_codes).","example":"86"},"country_code":{"type":"string","description":"The phone number's [country code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries).","example":"CN"},"country_name":{"type":"string","description":"The country name.","example":"China"},"display_number":{"maxLength":30,"type":"string","description":"The phone number's display number.","example":"+86 7777 777"},"number":{"maxLength":30,"type":"string","description":"The phone number.","example":"7777 777"}}}}},"description":"The group's [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F51844DRCX3K7BRTMZ40381R) settings."},"call_me_and_invite_by_phone":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the group has the [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VFZMDP4EJAF772N7NG2KY) setting enabled.","example":true},"require_press_1_for_call_me":{"type":"string","description":"Require Call Me users to press 1 before being connected to the meeting. \n* `auto` - Automatically determine whether to require pressing 1 before connecting to the meeting. \n* `always` - Always require Call Me users to press 1 before connecting to the meeting. \n* `never` - Never require Call Me users to press 1 before connecting to the meeting.","example":"auto","enum":["auto","always","never"],"x-enum-descriptions":["Automatically determine whether to require pressing 1 before connecting to the meeting.","Always require Call Me users to press 1 before connecting to the meeting.","Never require Call Me users to press 1 before connecting to the meeting."]},"call_out_countries":{"type":"object","properties":{"selected_countries":{"type":"array","description":"The list of selected countries/regions whose dial-in numbers will be listed in the email invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}}},"description":"The group's call out countries/regions settings."},"allow_webinar_attendees_call_me":{"type":"boolean","description":"Whether webinar attendees can use Call Me to connect audio. This feature is only available in version 5.2.2 and higher.","example":true}},"description":"The group's [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VG7NCJDZ238VVXZDJ8QMH) settings."},"personal_audio_conference":{"type":"boolean","description":"Whether the group has the [**Personal Audio Conference**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060449#h_01F5BPMNMERFWXN5S8ZJRZZCSE) setting enabled.","example":true},"participant_phone_masking":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the group has the [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5GT9P563K751K3JNAYE6E) setting enabled.","example":true},"masking_type":{"type":"string","description":"The type of phone number masking pattern to apply. \n* `mask_default` - Default masking pattern (Example: 888****666). \n* `mask_first_5` - Mask first five digits (Example: *****66666). \n* `mask_except_last_4` - Mask everything except last four digits (Example: *****6666).","example":"mask_default","enum":["mask_default","mask_first_5","mask_except_last_4"],"x-enum-descriptions":["Default masking pattern (Example: 888****666).","Mask first five digits (Example: *****66666).","Mask everything except last four digits (Example: *****6666)."]}},"description":"The group's [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5GT9P563K751K3JNAYE6E) settings."},"global_dial_in_countries":{"type":"object","properties":{"selected_countries":{"type":"array","description":"The list of selected countries/regions whose dial-in numbers will be listed in the email invitation. You can adjust the order that the dial-in numbers appear in the email invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The code of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"include_toll_free":{"type":"boolean","description":"Whether to include toll-free numbers in the email invitation for the selected countries/regions.","example":true}},"description":"The group's [**Global Dial-in Countries/Regions**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0068094#h_01F5KK9J31ZXNW10BRH86NHX4G) settings."}},"description":"The group's audio conference settings."},"email_notification":{"type":"object","properties":{"alternative_host_reminder":{"type":"boolean","description":"Notify the alternative host who is set or removed.","example":true},"cancel_meeting_reminder":{"type":"boolean","description":"Notify host and participants when the meeting is cancelled.","example":true},"cloud_recording_available_reminder":{"type":"boolean","description":"Whether to notify the host when a cloud recording is available.","example":true},"jbh_reminder":{"type":"boolean","description":"Notify host when participants join the meeting before them.","example":true},"recording_available_reminder_alternative_hosts":{"type":"boolean","description":"Whether to notify any alternative hosts when a cloud recording is available.","example":true},"recording_available_reminder_schedulers":{"type":"boolean","description":"Whether to notify the person who scheduled the meeting or webinar for the host when a cloud recording is available.","example":true},"schedule_for_reminder":{"type":"boolean","description":"Notify the host there is a meeting is scheduled, rescheduled, or cancelled.","example":true}}},"in_meeting":{"type":"object","properties":{"alert_guest_join":{"type":"boolean","description":"Allow participants who belong to your account to see that a guest (someone who does not belong to your account) is participating in the meeting/webinar.","example":true},"allow_users_to_delete_messages_in_meeting_chat":{"type":"boolean","description":"If the value of this field is set to `true`, allow users to delete messages in the in-meeting chat.\n","example":true},"allow_live_streaming":{"type":"boolean","description":"Whether livestreaming is enabled.","example":true},"allow_participants_chat_with":{"type":"integer","description":"Whether to allow participants to only chat with certain groups.\n* `1` - The participant cannot use chat.\n* `2` - Host and co-hosts only.\n * `3` - The participant can chat with other participants publicly.\n* `4` - The participant can chat with other participants publicly and privately.\n\n**Note:** This setting is only available with client versions 5.7.3 and above.","example":1,"enum":[1,2,3,4],"x-enum-descriptions":["No one","Host and co-hosts","Everyone","Everyone and anyone directly"]},"allow_show_zoom_windows":{"type":"boolean","description":"Show Zoom windows during screen share.","example":true},"allow_users_save_chats":{"type":"integer","description":"Whether to allow participants to save meeting chats.\n* `1` - Participants cannot save meeting chats.\n* `2` - Participants can only save host and co-host meeting chats.\n* `3` - Participants can save all meeting chats.","example":3,"enum":[1,2,3],"x-enum-descriptions":["Not allow","Host and co-hosts","Everyone"]},"annotation":{"type":"boolean","description":"Allow participants to use annotation tools to add information to shared screens.","example":true},"attendee_on_hold":{"type":"boolean","description":"Allow host to put attendee on hold.\n\n**This field has been deprecated and is no longer supported.**","example":true,"default":false},"auto_answer":{"type":"boolean","description":"Enable users to see and add contacts to 'auto-answer group' in the contact list on chat. Any call from members of this group will be automatically answered.","example":true},"auto_saving_chat":{"type":"boolean","description":"Automatically save all in-meeting chats.","example":true},"breakout_room":{"type":"boolean","description":"Allow host to split meeting participants into separate, smaller rooms.","example":true},"breakout_room_schedule":{"type":"boolean","description":"Whether the host can assign participants to breakout rooms when scheduling. This feature is **only** available in version 4.5.0 or higher.","example":true},"chat":{"type":"boolean","description":"Allow meeting participants to send chat message visible to all participants.","example":true},"meeting_question_answer":{"type":"boolean","description":"Allow participants to ask questions for the host and participants to answer.","example":true},"closed_caption":{"type":"boolean","description":"Allow host to type closed captions or assign a participant/third party device to add closed captions.","example":true},"closed_captioning":{"type":"object","properties":{"auto_transcribing":{"type":"boolean","description":"Whether to allow a live transcription service to transcribe meetings.","example":true},"enable":{"type":"boolean","description":"Whether to allow the host to type closed captions or assign a participant or 3rd-party service to provide closed captioning.","example":true},"save_caption":{"type":"boolean","description":"Whether to allow participants to save closed captions or transcripts.","example":true},"third_party_captioning_service":{"type":"boolean","description":"Whether to allow the use of an API token to integrate with 3rd-party closed captioning services.","example":true},"view_full_transcript":{"type":"boolean","description":"Whether to allow the viewing of full transcripts in the in-meeting side panel.","example":true}},"description":"Information about the group's closed captioning settings."},"co_host":{"type":"boolean","description":"Allow the host to add co-hosts. Co-hosts have the same in-meeting controls as the host.","example":true},"custom_data_center_regions":{"type":"boolean","description":"If set to `true`, you can [select data center regions](https://support.zoom.us/hc/en-us/articles/360042411451-Selecting-data-center-regions-for-hosted-meetings-and-webinars) to be used by this group for hosting their real-time meeting and webinar traffic. These regions can be provided in the `data_center_regions` field. If set to `false`, the regions cannot be customized and the default regions will be used.","example":true},"custom_live_streaming_service":{"type":"boolean","description":"Whether custom livestreaming is enabled.","example":true},"custom_service_instructions":{"type":"string","description":"The specific instructions to allow your account's meeting hosts to configure a custom livestream.","example":"The specific instructions"},"data_center_regions":{"type":"array","description":"If the value of `custom_data_center_regions` is `true`, a comma-separated list of these [data center regions](https://support.zoom.us/hc/en-us/articles/360059254691-Datacenter-abbreviation-list) to opt in to. \n* `AU` - Australia.\n* `LA` - Latin America. \n* `CA` - Canada. \n* `CN` - China. \n* `DE` - Germany. \n* `HK` - Hong Kong SAR. \n* `IN` - India. \n* `IE` - Ireland. \n* `TY` - Japan. \n* `MX` - Mexico. \n* `NL` - Netherlands. \n* `SG` - Singapore. \n* `US` - United States.","items":{"type":"string","example":"US","enum":["AU","LA","CA","CN","DE","HK","IN","IE","TY","MX","NL","SG","US"]}},"disable_screen_sharing_for_host_meetings":{"type":"boolean","description":"Whether to enable the **Disable desktop screen sharing for meetings you host** setting.","example":true},"disable_screen_sharing_for_in_meeting_guests":{"type":"boolean","description":"Whether to enable the **Disable screen sharing when guests are in the meeting** setting.","example":true},"e2e_encryption":{"type":"boolean","description":"Require that all meetings are encrypted using AES.","example":true},"entry_exit_chime":{"type":"string","description":"Play sound when participants join or leave.","example":"host","enum":["host","all","none"]},"far_end_camera_control":{"type":"boolean","description":"Allow another user to take control of the camera during a meeting.","example":true},"feedback":{"type":"boolean","description":"Enable users to provide feedback to Zoom at the end of the meeting.","example":true},"file_transfer":{"type":"boolean","description":"Whether [in-meeting file transfer](https://support.zoom.us/hc/en-us/articles/209605493-In-meeting-file-transfer) setting has been enabled for the users in the group or not.","example":true},"group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in Meeting. This will require more bandwidth.","example":true},"webinar_group_hd":{"type":"boolean","description":"Enable higher quality video for host and participants in Webinar. This will require more bandwidth.","example":true},"join_from_desktop":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their desktop browser. Note that the meeting experience from the desktop browser is limited.","example":true},"join_from_mobile":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their mobile browser. Note that the meeting experience from the mobile browser is limited.","example":true},"auto_generated_translation":{"type":"object","properties":{"language_item_pairList":{"type":"object","properties":{"trans_lang_config":{"type":"array","description":"A list of spoken languages and translation languages.","items":{"type":"object","properties":{"speak_language":{"type":"object","properties":{"name":{"type":"string","description":"The language's name.","example":"Chinese (Simplified)","enum":["Chinese (Simplified)","Dutch","English","French","German","Italian","Japanese","Korean","Portuguese","Russian","Spanish","Ukrainian"]},"code":{"type":"string","description":"The language's code.","example":"zh","enum":["zh","nl","en","fr","de","it","ja","ko","pt","ru","es","uk"]}},"description":"Language used in meetings."},"translate_to":{"type":"object","properties":{"all":{"type":"boolean","description":"Whether to select all the translation languages.","example":true},"language_config":{"type":"array","description":"A list of the translation languages.","items":{"type":"object","properties":{"name":{"type":"string","description":"The translation language's name.","example":"English","enum":["English"]},"code":{"type":"string","description":"The translation language's code.","example":"en","enum":["en"]}},"description":"An item of translation languages."}}},"description":"Information about all the translation languages."}},"description":"An item of spoken languages and translation languages in meetings."}},"all":{"type":"boolean","description":"Whether to select all spoken languages and translation languages","example":true}},"description":"Information about all spoken languages and translation languages in meetings."},"enable":{"type":"boolean","description":"Whether to allow users to enable automated translated captions in these language pairs in meetings.","example":true}},"description":"Information about the [Translate captions](https://support.zoom.us/hc/en-us/articles/8158738379917-Managing-automated-captions-) settings in meetings."},"language_interpretation":{"type":"object","properties":{"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"English"}},"enable_language_interpretation_by_default":{"type":"boolean","description":"Whether to enable language interpretation by default.","example":true},"allow_participants_to_speak_in_listening_channel":{"type":"boolean","description":"Whether to allow participants to speak in listening channel.","example":true},"allow_up_to_25_custom_languages_when_scheduling_meetings":{"type":"boolean","description":"Whether to allow up to 25 custom languages when scheduling meetings.","example":true},"enable":{"type":"boolean","description":"Whether to allow hosts to assign participants as interpreters who can interpret one language into another in real-time.","example":true}},"description":"Information about the [language interpretation](https://support.zoom.us/hc/en-us/articles/360034919791-Using-Language-Interpretation-in-your-meeting-or-webinar) settings."},"sign_language_interpretation":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow hosts to assign participants as sign language interpreters who can interpret one language into another in real-time.","example":true},"enable_sign_language_interpretation_by_default":{"type":"boolean","description":"Whether to enable sign language interpretation view by default in scheduler.","example":true},"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"Language1"}}},"description":"Allow hosts to assign participants as sign language interpreters who can interpret one language into sign language in real-time. Hosts can assign interpreters when scheduling, or during the meeting itself. This feature is only available with version 5.11.3 or later."},"live_streaming_facebook":{"type":"boolean","description":"Whether Facebook livestreaming is enabled.","example":true},"live_streaming_youtube":{"type":"boolean","description":"Whether YouTube livestreaming is enabled.","example":true},"manual_captioning":{"type":"object","properties":{"allow_to_type":{"type":"boolean","description":"Allow host to type or assign a participant to type.","example":true},"auto_generated_captions":{"type":"boolean","description":"Whether to allow a live transcription service to transcribe meetings.","example":true},"full_transcript":{"type":"boolean","description":"Whether to allow the viewing of full transcripts in the in-meeting side panel.","example":true},"manual_captions":{"type":"boolean","description":"Allow host to type closed captions or assign a participant/third party device to add closed captions.","example":true},"save_captions":{"type":"boolean","description":"Whether participants can save closed captions or transcripts.","example":true},"third_party_captioning_service":{"type":"boolean","description":"Whether to allow the use of an API token to integrate with 3rd-party closed captioning services.","example":true}}},"meeting_reactions":{"type":"boolean","description":"Whether meeting participants can [communicate using the emoji reactions](https://support.zoom.us/hc/en-us/articles/115001286183-Nonverbal-feedback-and-meeting-reactions) located in the **Reactions** menu in the meeting toolbar.","example":true},"meeting_reactions_emojis":{"type":"string","description":"Choose from these meeting reaction options.\n* `all` - All emojis: Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.\n* `selected` - Selected emojis: Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration) ","example":"all","enum":["all","selected"],"x-enum-descriptions":["Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.","Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration) ."]},"allow_host_panelists_to_use_audible_clap":{"type":"boolean","description":"Whether to allow hosts and panelists to use audible clap.","example":true},"webinar_reactions":{"type":"boolean","description":"Set this field to `true` to use [webinar reactions](https://support.zoom.us/hc/en-us/articles/4803536268429).","example":true},"meeting_survey":{"type":"boolean","description":"Whether to allow the host to present a survey to participants once a meeting has ended. This feature is only available in version 5.7.3 or higher.","example":true},"non_verbal_feedback":{"type":"boolean","description":"Allow participants in a meeting can provide nonverbal feedback and express opinions by clicking on icons in the Participants panel.","example":true},"only_host_view_device_list":{"type":"boolean","description":"Show the list of H.323/SIP devices only to the host.","example":true},"original_audio":{"type":"boolean","description":"Allow users to select original sound during a meeting.","example":true},"polling":{"type":"boolean","description":"Add 'Polls' to the meeting controls. This allows the host to survey the attendees.","example":true},"post_meeting_feedback":{"type":"boolean","description":"Display end-of-meeting experience feedback survey.","example":true},"private_chat":{"type":"boolean","description":"Allow meeting participants to send a private 1:1 message to another participant.","example":true},"record_play_own_voice":{"type":"boolean","description":"When each participant joins by telephone, allow the option to record and play their own voice as entry and exit chimes.","example":true},"remote_control":{"type":"boolean","description":"During screen sharing, allow the person who is sharing to let others control the shared content.","example":true},"remote_support":{"type":"boolean","description":"Allow meeting host to provide 1:1 remote support to another participant.","example":true},"request_permission_to_unmute_participants":{"type":"boolean","description":"Indicate whether the [**Request permission to unmute participants**](https://support.zoom.us/hc/en-us/articles/203435537-Muting-and-unmuting-participants-in-a-meeting#h_01EGK4XFWS1SJGZ71MYGKF7260) option should be enabled for the group or not.","example":true},"screen_sharing":{"type":"boolean","description":"Allow host and participants to share their screen or content during meetings.","example":true},"sending_default_email_invites":{"type":"boolean","description":"Allow users to invite participants by email only by default.","example":true},"show_a_join_from_your_browser_link":{"type":"boolean","description":"Whether to allow participants to join a meeting directly from their browser and bypass the Zoom application download process. This is useful for participants who cannot download, install, or run applications. Note that the meeting experience from the browser is limited.","example":true},"show_browser_join_link":{"type":"boolean","description":"Allow participants to join a meeting directly from their browser.","example":true},"show_device_list":{"type":"boolean","description":"Show the list of H.323/SIP devices.","example":true},"show_meeting_control_toolbar":{"type":"boolean","description":"Always show meeting controls during a meeting.","example":true},"slide_control":{"type":"boolean","description":"Whether the person sharing during a presentation can allow others to control the slide presentation. This feature is only available in version 5.8.3 or higher.","example":true},"stereo_audio":{"type":"boolean","description":"Allow users to select stereo audio during a meeting.","example":true},"use_html_format_email":{"type":"boolean","description":"Allow HTML formatting instead of plain text for meeting invitations scheduled with the Outlook plugin.","example":true},"virtual_background":{"type":"boolean","description":"Enable virtual backgrounds.","example":true},"waiting_room":{"type":"boolean","description":"Attendees cannot join a meeting until a host admits them individually from the waiting room.","example":true},"webinar_chat":{"type":"object","properties":{"allow_attendees_chat_with":{"type":"integer","description":"Allow webinar attendees to chat witn others in the webinar.\n* `1` - No one.\n* `2` - Host and all panelists.\n* `3` - Everyone.","example":3,"enum":[1,2,3]},"allow_auto_save_local_chat_file":{"type":"boolean","description":"Whether to automatically save chat messages to a local file on the host's computer when the webinar ends.","example":true},"allow_panelists_chat_with":{"type":"integer","description":"Allow webinar panelists to chat with others in the webinar.\n* `1` - Host and all panelists.\n* `2` - Everyone.","example":2,"enum":[1,2]},"allow_panelists_send_direct_message":{"type":"boolean","description":"Whether to allow webinar panelists to send direct messages to other panelists.","example":true},"allow_users_save_chats":{"type":"integer","description":"Whether webinar attendees can save chats.\n* `0` - Attendees cannot save chats.\n* `1` - Attendees can only save host and panelist chats.\n* `2` - Attendees can save all chats.","example":0,"enum":[0,1,2]},"default_attendees_chat_with":{"type":"integer","description":"By default, who to allow webinar attendees to chat with.\n* `1` - Host and all panelists.\n* `2` - Everyone.","example":1,"enum":[1,2]},"enable":{"type":"boolean","description":"Whether to allow webinar participants to send chat messages.","example":true}}},"webinar_live_streaming":{"type":"object","properties":{"custom_service_instructions":{"type":"string","description":"The specific instructions to allow your account's meeting hosts to configure a custom livestream.","example":"The specific instructions"},"enable":{"type":"boolean","description":"Whether webinar livestreaming is enabled.","example":true},"live_streaming_reminder":{"type":"boolean","description":"Whether to notify users to watch the livestream. This does not apply to custom RTMP (real-time messaging protocol).","example":true},"live_streaming_service":{"type":"array","description":"The available livestreaming services.\n* `facebook`\n* `workplace_by_facebook`\n* `youtube`\n* `custom_live_streaming_service`","items":{"type":"string","example":"Facebook","enum":["facebook","workplace_by_facebook","youtube","custom_live_streaming_service"],"x-enum-descriptions":["Facebook","Workplace by Facebook","YouTube","Custom Live Streaming Service"]}}}},"meeting_polling":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow the host to add polls before or during a meeting.","example":true},"advanced_polls":{"type":"boolean","description":"Whether to allow host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. Hosts can also set the correct answers for quizzes they create.","example":true},"manage_saved_polls_and_quizzes":{"type":"boolean","description":"Whether to allow users to manage saved polls and quizzes from meetings.","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow host to upload an image for each question.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true}},"description":"Information about the account's meeting polling settings."},"webinar_polling":{"type":"object","properties":{"advanced_polls":{"type":"boolean","description":"Whether to allow host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. Hosts can also set the correct answers for quizzes they create.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true},"manage_saved_polls_and_quizzes":{"type":"boolean","description":"Whether to allow users to manage saved polls and quizzes from Webinars","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow host to upload an image for each question.","example":true},"enable":{"type":"boolean","description":"Whether to allow the host to add polls before or during a webinar.","example":true}}},"webinar_question_answer":{"type":"boolean","description":"Whether attendees can ask the host and panelists questions in the webinar.","example":true},"webinar_survey":{"type":"boolean","description":"Whether to allow the host to present surveys to attendees once a webinar has ended.","example":true},"whiteboard":{"type":"boolean","description":"Allow participants to share a whiteboard that includes annotation tools.","example":true},"who_can_share_screen":{"type":"string","description":"Indicates who can share their screen or content during meetings. The value can be one of the following: \n \n`host`: Only host can share the screen. \n \n`all`: Both hosts and attendees can share their screen during meetings. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"host","enum":["host","all"]},"who_can_share_screen_when_someone_is_sharing":{"type":"string","description":"Indicates who is allowed to start sharing screen when someone else in the meeting is sharing their screen. The value can be one of the following: \n \n`host`: Only a host can share the screen when someone else is sharing. \n \n`all`: Anyone in the meeting is allowed to start sharing their screen when someone else is sharing. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"all","enum":["host","all"]},"participants_share_simultaneously":{"type":"string","description":"Indicates how many participants can share at the same time. The value can be one of the following: \n \n`one`: Only one participant can share at a time\n. \n \n`multiple`: Multiple participants can share simultaneously (dual monitors recommended)\n. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"multiple","enum":["multiple","one"]},"workplace_by_facebook":{"type":"boolean","description":"Whether Workplace by Facebook is enabled.","example":true}}},"other_options":{"type":"object","properties":{"allow_users_contact_support_via_chat":{"type":"boolean","description":"Whether to display the Zoom help badge on the bottom-right of the page.","example":true},"blur_snapshot":{"type":"boolean","description":"Whether iOS blurs the screenshot in the task switcher when multiple apps are open. Android hides the screenshot in the system-level list of recent apps.","example":true},"webinar_registration_options":{"type":"object","properties":{"allow_host_to_enable_join_info":{"type":"boolean","description":"Allow host to enable **Show join info on registration confirmation page**.","example":true},"allow_host_to_enable_social_share_buttons":{"type":"boolean","description":"Allow host to enable **Show social share buttons on registration page**.","example":true},"enable_custom_questions":{"type":"boolean","description":"Enable custom questions.","example":true}},"description":"Webinar registration options."}}},"profile":{"title":"Profile","type":"object","properties":{"recording_storage_location":{"type":"object","properties":{"allowed_values":{"type":"array","description":"Users can choose the country to store their recorded content. Content can include meeting, webinar, and phone recordings, as well as voicemail, transcripts, and custom greeting prompts. See [Managing the Communications Content storage location](https://support.zoom.us/hc/en-us/articles/360050781131) for details.\n\nProvide abbreviated country codes as the value for this field. See the [Countries abbreviation list](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) for details.","items":{"type":"string","example":"US"}},"value":{"type":"string","description":"Abbreviated country code.","example":"US"}}}}},"recording":{"type":"object","properties":{"account_user_access_recording":{"type":"boolean","description":"Make cloud recordings accessible to account members only.","example":true},"archive":{"type":"object","properties":{"enable":{"type":"boolean","description":"Enable the archiving feature.","example":true},"settings":{"type":"object","properties":{"audio_file":{"type":"boolean","description":"Include in-meeting or in-webinar audio in the archive.","example":true},"cc_transcript_file":{"type":"boolean","description":"Include closed caption or transcript in the archive.","example":true},"chat_file":{"type":"boolean","description":"Include in-meeting chat in the archive.","example":true},"chat_with_sender_email":{"type":"boolean","description":"Include user email in in-meeting chat file.","example":true},"video_file":{"type":"boolean","description":"Include in-meeting or in-webinar video in the archive.","example":true}}},"type":{"type":"integer","description":"Archive types.\n\n* `1` - Only meetings are archived. \n \n* `2` - Only webinars are archived. \n \n* `3` - Both meetings and webinars are archived.","example":1,"enum":[1,2,3]}},"description":"[Archiving solution](https://support.zoom.us/hc/en-us/articles/360050431572-Archiving-Meeting-and-Webinar-data) settings. This setting can only be used if you have been granted archiving solution access by the Zoom Support team."},"auto_recording":{"type":"string","description":"Record meetings automatically as they start.","example":"local"},"cloud_recording":{"type":"boolean","description":"Allow hosts to record and save the meeting or webinar in the cloud.","example":true},"cloud_recording_download":{"type":"boolean","description":"Allow anyone with a link to the cloud recording to download.","example":true},"cloud_recording_download_host":{"type":"boolean","description":"Allow only the host with a link to the cloud recording to download.","example":true},"host_delete_cloud_recording":{"type":"boolean","description":"Allow the host to delete the recordings. If this option is disabled, the recordings cannot be deleted by the host and only admin can delete them.","example":true},"record_files_separately":{"type":"object","properties":{"active_speaker":{"type":"boolean","description":"Whether recording only the active speaker is enabled.","example":true},"gallery_view":{"type":"boolean","description":"Whether recording only the gallery view is enabled.","example":true},"shared_screen":{"type":"boolean","description":"Whether recording only shared screen is enabled.","example":true}},"description":"The account's [**Record active speaker, gallery view and shared screen separately**](https://support.zoom.us/hc/en-us/articles/360060316092-Changing-basic-and-advanced-cloud-recording-settings#h_01F4CYJTCTXNS2MXH00W9EFG6R) settings."},"display_participant_name":{"type":"boolean","description":"Whether participants' names display in the recording.","example":true},"recording_thumbnails":{"type":"boolean","description":"Whether thumbnails of the presenter are recorded when they are sharing their screen.","example":true},"optimize_recording_for_3rd_party_video_editor":{"type":"boolean","description":"Whether recordings will be optimized for a 3rd party video editor. This can increase the file size and the time it takes to generate recording files.","example":true},"recording_highlight":{"type":"boolean","description":"Whether the [recording highlights](https://support.zoom.us/hc/en-us/articles/360060802432) feature is enabled.","example":true,"deprecated":true},"save_panelist_chat":{"type":"boolean","description":"Whether panelist chats are saved to the recording.","example":true},"save_poll_results":{"type":"boolean","description":"Whether poll results shared during the meeting or webinar are saved. This also includes poll results shared during the meeting or webinar.","example":true},"save_close_caption":{"type":"boolean","description":"Whether [closed captions](https://support.zoom.us/hc/en-us/articles/207279736) are saved as a VTT (Video Track Text) file.","example":true},"ip_address_access_control":{"type":"object","properties":{"enable":{"type":"boolean","description":"If set to `true`, this account's the cloud recordings can only be accessed by the IP addresses defined in the `ip_addresses_or_ranges` property.\n\n","example":true},"ip_addresses_or_ranges":{"type":"string","description":"IP addresses or ranges that have access to the cloud recordings. Separate multiple IP ranges with comma. Use `n.n.n.n`, `n.n.n.n/n` or `n.n.n.n - n.n.n.n` syntax where n is a number.\n\nExamples: `46.33.24.184, 48.99.100.2/25` or `200.181.108.17 - 220.181.108.157`\n\n","example":"200.181.108.17 - 220.181.108.157"}},"description":"Setting to allow cloud recording access only from specific IP address ranges.\n"},"local_recording":{"type":"boolean","description":"Allow hosts and participants to record the meeting to a local file.","example":true},"local_recording_options":{"type":"object","properties":{"internal_meeting_participants":{"type":"boolean","description":"Internal meeting participants","example":true},"internal_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"external_meeting_participants":{"type":"boolean","description":"External meeting participants","example":true},"external_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"participants_with_specified_domains":{"type":"boolean","description":"Meeting participants with specified domains","example":true},"participants_with_specified_domains_content":{"type":"string","description":"Enter the domain information","example":"zoom.us"},"participants_specified_domains_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"save_chat_messages":{"type":"boolean","description":"Save chat messages from the meeting / webinar","example":true},"save_closed_caption":{"type":"boolean","description":"Save closed caption as a VTT file","example":true}},"description":"all sub-options for local recording"},"prevent_host_access_recording":{"type":"boolean","description":"If set to `true`, meeting hosts can't view their meeting cloud recordings. Only the admins who have recording management privilege can access them.\n\n","example":true},"record_audio_file":{"type":"boolean","description":"Whether to record one audio file for all participants.","example":true},"record_gallery_view":{"type":"boolean","description":"When someone is sharing their screen, active speaker will show on the top right corner of the shared screen.","example":true},"record_speaker_view":{"type":"boolean","description":"Record active speaker with shared screen.","example":true},"recording_audio_transcript":{"type":"boolean","description":"Automatically transcribe the audio of a meeting or webinar for cloud recordings.","example":true},"smart_recording":{"type":"object","properties":{"create_recording_highlights":{"type":"boolean","description":"By selecting this option, meeting details in the audio transcript will be highlighted. Hosts can modify highlighted sections and generate a video summary (highlighted sections may have a 3-second offset) based on these sections. The summary is for informational purposes only and may not be complete.","example":true},"create_smart_chapters":{"type":"boolean","description":"By selecting this option, your recording will have chapters with overview. Hosts can edit the chapters.","example":true},"create_next_steps":{"type":"boolean","description":"By selecting this option, there will be a summary of actions to take after the recorded meeting.","example":true}},"description":"By selecting this option, your recording will have meeting smart chapters, and next steps. You are directing Zoom to access, process, and use your account's recording data for the purpose of analysis and insights."},"save_chat_text":{"type":"boolean","description":"Save chat messages from the meeting or webinar.","example":true},"show_timestamp":{"type":"boolean","description":"Add a timestamp to the recording.","example":true},"recording_notification_for_zoom_client":{"type":"object","properties":{"disclaimer_to_participants":{"type":"string","description":"This field updates child setting name is [Show a disclaimer to participants when a recording starts]. All participants or Guest only.","example":"All participants","enum":["All participants","Guest only"]},"play_voice_prompt":{"type":"string","description":"This field updates child setting name is [Play voice prompt for]. All participants or Guest only or No one","example":"All participants","enum":["All participants","Guest only","No one"]},"ask_host_to_confirm":{"type":"boolean","description":"This field updates the child setting name is [Ask host to confirm before starting a recording], true: enable, false: disable","example":true}},"description":"You can update the setting name: Recording notifications - Zoom clients"},"viewer_see_transcript":{"type":"boolean","description":"Viewers can see the transcript","example":true},"viewer_see_chat":{"type":"boolean","description":"Viewers see chat","example":true},"allow_cmr_3rd_party_bot":{"type":"boolean","description":"Allow 3rd-party recording","example":true},"upload_recording":{"type":"boolean","description":"Upload recording to the cloud","example":true},"water_marker_recording":{"type":"boolean","description":"add water marker for recording","example":true},"durable_meeting_transcript":{"type":"object","properties":{"durable_meeting_transcript":{"type":"boolean","description":"Main setting value","example":true},"allow_host_access_meeting_transcript":{"type":"boolean","description":"Allow hosts to access and manage transcripts","example":true}},"description":"Allow users to retain, access,and manage transcripts generated by AI Companion features for use by other AI Companion services."},"allow_share":{"type":"boolean","description":"Allow cloud recording sharing","example":true},"authenticated_view_cloud_recoding":{"type":"object","properties":{"authenticated_can_view_cloud_recordings":{"type":"boolean","description":"Main setting value","example":true},"default_authenticate_content":{"type":"string","description":"Default authentication option","example":"Signed-in users in my account","enum":["Signed-in users in my account","Sign in to Zoom","Sign in to Zoom with specified domains","Sign in to external Single Sign-On (SSO)","Only people with access"]}},"description":"Require users to authenticate before viewing cloud recordings"},"embed_passcode_in_shareable_link":{"type":"boolean","description":"Embed passcode in the shareable link for one-click access","example":true},"allow_invitees_access_recordings_without_passcode":{"type":"boolean","description":"Allow invitees to access recordings without the passcode","example":true},"recording_as_on_demand":{"type":"boolean","description":"Set recording as on-demand by default","example":true},"notification_subscription_url_when_recording_available":{"type":"boolean","description":"Push notification to subscription URL when a cloud recording is available","example":true},"recording_notifications_phone_users":{"type":"object","properties":{"require_press_one_consent_to_record":{"type":"boolean","description":"Require phone-only users to press 1 to consent to being recorded","example":true},"multiple_notifications_phone_users":{"type":"boolean","description":"Multiple notifications for phone users","example":true}},"description":"Recording notifications - Phone users"},"cloud_recording_permanently_deleted":{"type":"object","properties":{"cloud_recording_permanently_deleted_from_trash":{"type":"boolean","description":"Main setting value","example":true},"email_reminder_type":{"type":"string","description":"Selected email reminder","example":"Weekly digest on Monday","enum":["7 days before deletion","Weekly digest on Monday"]}},"description":"When the cloud recording is going to be permanently deleted from trash"},"recording_storage_email_notifications":{"type":"boolean","description":"Recording storage email notifications","example":true},"allow_add_cloud_recordings_to_zoom_clips":{"type":"boolean","description":"Allow users to add cloud recordings to Zoom Clips","example":true},"allow_revenue_accelerator_manage_recording_separate_auto_delete":{"type":"boolean","description":"Allow Zoom Revenue Accelerator to manage recording files with separate auto-delete settings","example":true}}},"schedule_meeting":{"type":"object","properties":{"audio_type":{"type":"string","description":"Determine how participants can join the audio portion of the meeting.","example":"both"},"embed_password_in_join_link":{"type":"boolean","description":"If the value is set to `true`, the meeting passcode will be encrypted and included in the join meeting link to allow participants to join with just one click without having to enter the passcode.\n ","example":true},"force_pmi_jbh_password":{"type":"boolean","description":"If join before host option is enabled for a personal meeting, then enforce passcode requirement.","example":true,"deprecated":true},"host_video":{"type":"boolean","description":"Start meetings with host video on.","example":true},"join_before_host":{"type":"boolean","description":"Allow participants to join the meeting before the host arrives","example":true},"mute_upon_entry":{"type":"boolean","description":"Automatically mute all participants when they join the meeting.","example":true},"participant_video":{"type":"boolean","description":"Start meetings with participant video on.","example":true},"pstn_password_protected":{"type":"boolean","description":"Generate and send new passcodes for newly scheduled or edited meetings.","example":true},"require_password_for_all_meetings":{"type":"boolean","description":"Require passcode from all participants before joining a meeting.","example":true},"require_password_for_instant_meetings":{"type":"boolean","description":"If enabled, a random passcode will be generated on the user's end who starts the instant meeting. Other participants will have to enter the passcode to join the meeting. If you use personal meeting ID (PMI) for your instant meetings, this option will be disabled.","example":true},"require_password_for_pmi_meetings":{"type":"string","description":"Indicates whether a passcode is required for [PMI](https://support.zoom.us/hc/en-us/articles/203276937-Using-Personal-Meeting-ID-PMI-) meetings or not. \n \n`none` - Do not require passcode for PMI meetings. \n \n`all` - Require participants to enter passcode for all PMI enabled meetings. \n `jbh_only`: Require passcode only for meetings where the **join before host** setting is enabled.","example":"jbh_only","enum":["all","jbh_only","none"]},"require_password_for_scheduled_meetings":{"type":"boolean","description":"Require a passcode for meetings which have already been scheduled.\n","example":true},"require_password_for_scheduling_new_meetings":{"type":"boolean","description":"This setting applies for regular meetings that do not use PMI. If enabled, a passcode will be generated while a host schedules a new meeting and participants will be required to enter the passcode before they can join the meeting. ","example":true},"upcoming_meeting_reminder":{"type":"boolean","description":"Receive desktop notification for upcoming meetings.","example":true},"always_display_zoom_meeting_as_topic":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable the **Always display `Zoom Meeting` as the meeting topic** setting.","example":false},"display_topic_for_scheduled_meetings":{"type":"boolean","description":"Whether to display **Zoom Meeting** as the topic for already-scheduled meetings.","example":false}},"description":"Information about the [**Always display `Zoom Meeting` as the meeting topic**](https://support.zoom.us/hc/en-us/articles/201363253-Changing-account-settings#h_01EG9BJ646V2WJK1S3H2MP6YV6) setting."},"always_display_zoom_webinar_as_topic":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable the **Always show `Zoom Webinar` as the webinar topic** setting.","example":false},"display_topic_for_scheduled_webinars":{"type":"boolean","description":"Whether to display **Zoom Webinar** as the topic for already-scheduled meetings.","example":false}},"description":"Information about the [**Always show `Zoom Webinar` as the webinar topic**](https://support.zoom.us/hc/en-us/articles/201363253-Changing-account-settings#h_01EG9BJ646V2WJK1S3H2MP6YV6) setting."},"continuous_meeting_chat":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable the **Enable continuous meeting chat** setting.","example":true},"can_add_external_users":{"type":"boolean","description":"Whether to enable the **External users can be added** setting.","example":true},"auto_add_invited_external_users":{"type":"boolean","description":"Whether to enable the **Automatically add invited external users** setting.","example":true}},"description":"Information about the **Enable continuous meeting chat** feature."}}},"telephony":{"type":"object","properties":{"audio_conference_info":{"type":"string","description":"Third party audio conference info.","example":"test"},"third_party_audio":{"type":"boolean","description":"Allow users to join the meeting using the existing 3rd party audio configuration.","example":true}},"description":"Group Settings: Telephony."},"chat":{"type":"object","properties":{"share_files":{"type":"object","properties":{"enable":{"type":"boolean","description":"Allow users of this account to send and receive files in chats and channels. When disabled, users can still take and share screenshots.","example":true},"share_option":{"type":"string","description":"Allow users of this account to send and receive files in chats and channels. When disabled, users can still take and share screenshots.","example":"true","enum":["anyone","account","organization"],"x-enum-descriptions":["Anyone (internal and external contacts)","In the same account","In the same organization"]}},"description":"Users can share files in chats and channels."},"chat_emojis":{"type":"object","properties":{"enable":{"type":"boolean","description":"Allow users to use the emoji library in direct messages or group conversations. Choose between allowing users to use any emoji in the library, or choose to allow only pre-selected emojis. If the setting is disabled, users can still use keyboard shortcuts to add emojis. Users can change their emoji skin tone in Settings.","example":true},"emojis_option":{"type":"string","example":"all","enum":["all","selected"],"x-enum-descriptions":["All emojis","Selected emojis"]}},"description":"Chat emojis."},"record_voice_messages":{"type":"boolean","description":"Allow users to record voice messages that can be sent in direct messages or group conversations.","example":true},"record_video_messages":{"type":"boolean","description":"Allow users to record video messages that can be sent in direct messages or group conversations. If the file share setting is disabled, they will not be able to record and send video messages.","example":true},"screen_capture":{"type":"boolean","description":"Allow users to take and send screenshots in direct messages or group conversations.","example":true},"create_public_channels":{"type":"boolean","description":"Allow users to create public channels.","example":true},"create_private_channels":{"type":"boolean","description":"Allow users to create private channels.","example":true},"share_links_in_chat":{"type":"boolean","description":"Share links to messages and channels in Team Chat.","example":true},"schedule_meetings_in_chat":{"type":"boolean","description":"Schedule a meeting from chat or channel.","example":true},"set_retention_period_in_cloud":{"type":"object","properties":{"enable":{"type":"boolean","description":"By default, messages and files are stored in Zoom's cloud. Enable this setting to specify when they are deleted. When retention is disabled, messages sent by offline users can be received within 7 days before they are deleted.","example":true},"retention_period_of_direct_messages_and_group_conversation":{"type":"string","description":"Delete direct messages and group conversations after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"},"retention_period_of_channels":{"type":"string","description":"Delete data in channels after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"}},"description":"Set retention period for messages and files in Zoom's cloud."},"set_retention_period_in_local":{"type":"object","properties":{"enable":{"type":"boolean","description":"Specify how long your messages are saved on local devices. If this setting is disabled, messages are never deleted locally.","example":true},"retention_period_of_direct_messages_and_group_conversation":{"type":"string","description":"Delete direct messages and group conversations after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"},"retention_period_of_channels":{"type":"string","description":"Delete data in channels after retention period. 'y' - year, 'm' - month, 'd' - day","example":"2m"}},"description":"Store messages on local devices, excluding personal channel messages."},"allow_users_to_search_others_options":{"type":"string","description":"Allow users to search others, when selecting multiple items, separate them with commas. \n* ''-none. \n* '1' - In the same account. \n* '2' - Under the same master account, including all sub acounts. \n* '3' - Under the same organization.","example":"1,3"},"allow_users_to_add_contacts":{"type":"object","properties":{"enable":{"type":"boolean","description":"By disabling this setting, users will not be able to add contacts.","example":true},"selected_option":{"type":"integer","description":"The type of allowing users to add contacts: \n* 1 - Anyone (internal and external contacts). \n* 2 - In the same organization. \n* 3 - In the same organization and specified domains. \n* 4 - In the same organization and specified users.","example":4,"enum":[1,2,3,4]},"user_email_addresses":{"type":"string","description":"The domains or emails (internal or external). \n* When the `selected_option` field value is `3`, the value is internal or external domains. Use a comma to separate multiple domains. Example: company.com. \n* When the `selected_option` field value is `4`, the value is internal or external email addresses. Use a comma to separate multiple emails.","example":"123@test.com"}},"description":"Allow users to add contacts."},"allow_users_to_chat_with_others":{"type":"object","properties":{"enable":{"type":"boolean","description":"If you select 'In the same organization', users may still be able to chat with external users if they are added to channels or group chats with external users.","example":true},"selected_option":{"type":"integer","description":"The type of allowing users to add contacts: \n* 1 - Anyone (internal and external contacts). \n* 2 - In the same organization. \n* 3 - In the same organization and specified domains. \n* 4 - In the same organization and specified users.","example":4,"enum":[1,2,3,4]},"user_email_addresses":{"type":"string","description":"The domains or emails (internal or external). \n* When the `selected_option` field value is `3`, the value is internal or external domains. Use a comma to separate multiple domains. Example: company.com. \n* When the `selected_option` field value is `4`, the value is internal or external email addresses. Use a comma to separate multiple emails.","example":"123@test.com"}},"description":"Allow users to chat with others."},"chat_etiquette_tool":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable the **Chat Etiquette Tool**. This value defaults to `false`. \n\n The **Chat Etiquette Tool** allows you to define specific keywords and text patterns in chat to prevent users from inadvertently sharing unwanted messages.","example":true,"default":false},"policies":{"type":"array","description":"Information about the defined **Chat Etiquette Tool** policies.","items":{"type":"object","properties":{"id":{"type":"string","description":"The policy ID.","example":"aefwf23dsv;sdo-khuity8"},"status":{"type":"string","description":"The policy's current status: \n* `activated` - Activated. \n* `deactivated` - Deactivated.","example":"Activated","enum":["activated","deactivated"],"x-enum-descriptions":["Activated.","Deactivated."]}}}}},"description":"Information about the **Chat Etiquette** Tool."},"send_data_to_third_party_archiving_service":{"type":"object","properties":{"enable":{"type":"boolean","description":"Allow users to send data to third-party archiving service.","example":true}},"description":"Send data to third-party archiving service."},"translate_messages":{"type":"boolean","description":"Allow users to translate team chat messages. [Learn more].(https://support.zoom.us/hc/en-us/articles/12998089084685)","example":true},"search_and_send_animated_gif_images":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow users to search GIF images from GIPHY when they compose messages.","example":true}},"description":"Allow users to search GIF images from GIPHY when they compose messages. See GIPHY's website for more information about content ratings."}},"description":"The account's chat settings."}}},{"title":"GroupSettingsAuthenticationUpdate","oneOf":[{"type":"object","properties":{"authentication_option":{"type":"object","properties":{"action":{"type":"string","description":"Authentication action","example":"update","enum":["update","show","hide"]},"default_option":{"type":"boolean","description":"Authentication default option","example":true},"domains":{"type":"string","description":"Authentication domains","example":"example.com"},"id":{"type":"string","description":"Authentication id","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"Authentication name","example":"Authentication name"},"type":{"type":"string","description":" Authentication type. Specify one of the following authentication types for the authentication profile: \n \n * `enforce_login`: This option allows any users to join the meeting or webinar, as long as they are signed into their Zoom account.\n * `enforce_login_with_domains`: This option, allows you to specify a rule so that only those Zoom users whose email addresses contain a certain domain, can join the meeting or webinar. You can either add multiple domains using a comma in between and/or use a wildcard for listing domains. \n \n * `enforce_login_with_same_account`: This option allows users to join the meeting or webinar with the same Zoom account.","example":"enforce_login_with_domains","enum":["enforce_login","enforce_login_with_same_account","enforce_login_with_domains"]}},"description":"Meeting Authentication Options"},"meeting_authentication":{"type":"boolean","description":"Only authenticated users can join meetings","example":true}}},{"type":"object","properties":{"authentication_option":{"type":"object","properties":{"action":{"type":"string","description":"Authentication action","example":"update","enum":["update","show","hide"]},"default_option":{"type":"boolean","description":"Authentication default option","example":true},"domains":{"type":"string","description":"Authentication domains","example":"example.com"},"id":{"type":"string","description":"Authentication id","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"Authentication name","example":"Authentication name"},"type":{"type":"string","description":"Authentication type","example":"enforce_login_with_domains","enum":["internally","enforce_login","enforce_login_with_domains"]}},"description":"Authentication Options"},"recording_authentication":{"type":"boolean","description":"Only authenticated users can view cloud recordings","example":true}}}]},{"title":"Meeting/Webinar Security Group Settings","type":"object","properties":{"meeting_security":{"type":"object","properties":{"auto_security":{"type":"boolean","description":"Whether to require that all meetings are secured with at least one security option. \n\n This setting can only be disabled by Enterprise, ISV, Business (with more than 100 licenses), and Education accounts.","example":true},"block_user_domain":{"type":"boolean","description":"Whether to block users in specific domains from joining meetings and webinars.","example":true},"block_user_domain_list":{"maxItems":20,"type":"array","description":"The domain to block, up to 20 domains. For example, the `*.example.com` domain.","items":{"maxLength":30,"minLength":5,"type":"string","example":"*.example.com"}},"chat_etiquette_tool":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable the **Chat Etiquette Tool**. This value defaults to `false`. \n\n The **Chat Etiquette Tool** allows you to define specific keywords and text patterns in chat to prevent users from inadvertently sharing unwanted messages.","example":true,"default":false},"policies":{"type":"array","description":"Information about the defined **Chat Etiquette Tool** policies.","items":{"type":"object","properties":{"id":{"type":"string","description":"The policy ID.","example":"aefwf23dsv;sdo-khuity8"},"status":{"type":"string","description":"The policy's current status: \n* `activated` - Activated. \n* `deactivated` - Deactivated.","example":"Activated","enum":["activated","deactivated"],"x-enum-descriptions":["Activated.","Deactivated."]}}}}},"description":"Information about the **Chat Etiquette** Tool."},"embed_password_in_join_link":{"type":"boolean","description":"Whether the meeting passcode will be encrypted and included in the invitation link. The provided link will allow participants to join the meeting without having to enter the passcode.","example":true},"encryption_type":{"type":"string","description":"The type of encryption to use when starting a meeting: \n* `enhanced_encryption` - Use enhanced encryption. Encryption data is stored in the cloud. \n* `e2ee` - End-to-end encryption. The encryption key is stored on the local device and cannot be obtained by anyone else. Enabling E2EE also [**disables** certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":"e2ee","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Whether to enable end-to-end encryption for meetings. If enabled, you can specify the type of encryption in the `encryption_type` field.","example":true},"meeting_password":{"type":"boolean","description":"Whether all instant and scheduled meetings that users can join via client or Zoom Rooms systems are passcode-protected. [Personal Meeting ID (PMI)](https://support.zoom.us/hc/en-us/articles/203276937) meetings are **not** included in this setting.","example":true},"meeting_password_requirement":{"type":"object","properties":{"consecutive_characters_length":{"type":"integer","description":"The maximum length of consecutive characters (for example, `abcdef`) allowed in a passcode. \n* `4` through `8` - The maximum consecutive characters length. The length is `n` minus `1`, where `n` is the provided value. For example, if you provide the `4` value, there can only be a maximum of `3` consecutive characters in a passcode, such as `abc1x@8fdh`. \n* `0` - Do not apply a consecutive character restriction.","example":8,"enum":[0,4,5,6,7,8]},"have_letter":{"type":"boolean","description":"Whether the passcode must contain at least one alphabetic character.","example":true},"have_number":{"type":"boolean","description":"Whether the passcode must contain at least one numeric character.","example":true},"have_special_character":{"type":"boolean","description":"Whether the passcode must contain at least one special character. For example, `!`, `@`, and/or `#` characters.","example":true},"have_upper_and_lower_characters":{"type":"boolean","description":"Whether the passcode must include uppercase and lowercase characters.","example":true},"length":{"type":"integer","description":"The passcode's minimum length.","example":10},"only_allow_numeric":{"type":"boolean","description":"Whether the passcode must contain **only** numeric characters.","example":true},"weak_enhance_detection":{"type":"boolean","description":"Whether users will be informed when the provided passcode is weak.","example":true}},"description":"Information about the meeting and webinar [passcode requirements](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604)."},"only_authenticated_can_join_from_webclient":{"type":"boolean","description":"Whether to specify that only authenticated users can join the meeting from the web client.","example":true},"phone_password":{"type":"boolean","description":"Whether to require a passcode for participants joining by phone. \n\n If enabled and the meeting is passcode-protected, a numeric passcode is required for participants to join by phone. For meetings with alphanumeric passcodes, a numeric passcode will be generated.","example":true},"pmi_password":{"type":"boolean","description":"Whether all PMI meetings that users can join via client or Zoom Rooms systems are passcode-protected.","example":true},"require_password_for_scheduled_meeting":{"type":"boolean","description":"Whether to require a passcode for meetings that have already been scheduled.","example":true},"require_password_for_scheduled_webinar":{"type":"boolean","description":"Whether to require a passcode for webinars that have already been scheduled.","example":true},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**waiting room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting. \n\n If the **Waiting Room** feature is enabled, the [**Allow participants to join before host**](https://support.zoom.us/hc/en-us/articles/202828525-Allow-participants-to-join-before-host) setting is automatically disabled.","example":true},"waiting_room_settings":{"type":"object","properties":{"participants_to_place_in_waiting_room":{"type":"integer","description":"The type of participants to be admitted to the waiting room. \n* `0` - All attendees. \n* `1` - Users who are not in your account. \n* `2` - Users who are not in your account and are not part of your [allowed domains list](https://support.zoom.us/hc/en-us/articles/360037117472-Configuring-authentication-profiles#h_e3cf0d5f-eec7-4c2a-ad29-ef2a5079a7da).","example":1,"enum":[0,1,2]},"users_who_can_admit_participants_from_waiting_room":{"type":"integer","description":"The users who can admit participants from the waiting room. \n* `0` - Host and co-hosts only. \n* `1` - Host, co-hosts, and anyone who bypassed the waiting room if the host and co-hosts are not present.","example":1,"enum":[0,1]},"whitelisted_domains_for_waiting_room":{"type":"string","description":"If the `participants_to_place_in_waiting_room` field is `2`, a comma-separated list of the domains that can bypass the waiting room, such as `example.com,example2.com`.","example":"example.com"}},"description":"Information about the waiting room settings."},"webinar_password":{"type":"boolean","description":"Whether to generate a passcode when scheduling webinars. Participants must use the generated passcode to join the scheduled webinar.","example":true}}}},"description":"The group's updated meeting and webinar security settings."}]}}}},"responses":{"204":{"description":"Setting updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account, {accountId}
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n Group does not exist: {groupId}.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:update:settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:update:settings:admin"]}}},"/groups/{groupId}/settings/registration":{"get":{"tags":["Groups"],"summary":"Get a group's webinar registration settings","description":"Get webinar registration settings for a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-). \n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:admin`,`group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:read:registration_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupSettingsRegistration","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}},{"name":"type","in":"query","description":"The registration type: \n* `webinar` — webinar.","required":false,"schema":{"type":"string","example":"webinar","enum":["webinar"],"x-enum-descriptions":["webinar"]}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \n Group settings registration information returned.","content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"host_email_notification":{"type":"boolean","description":"Send an email to host when someone registers.","example":true},"close_registration":{"type":"boolean","description":"Close registration after event date.","example":true},"allow_participants_to_join_from_multiple_devices":{"type":"boolean","description":"Allow participants to join from multiple devices","example":true},"show_social_share_buttons":{"type":"boolean","description":"Show social share buttons on registration page","example":true}},"description":"When participants submit registration, do something."},"questions":{"type":"array","description":"Array of Registrant Questions.","items":{"type":"object","properties":{"field_name":{"type":"string","description":"Field name of the question.","example":"last_name","enum":["last_name","address","city","country","zip","state","phone","industry","org","job_title","purchasing_time_frame","role_in_purchase_process","no_of_employees","comments"],"x-enum-descriptions":["Last Name","Address","City","Country/Region","Zip/Postal Code","State/Province","Phone","Industry","Organization","Job Title","Purchasing Time Frame","Role in Purchase Process","Number of Employees","Questions & Comments"]},"required":{"type":"boolean","description":"Decide whether this field are required.","example":true},"selected":{"type":"boolean","description":"Indicates whether or not the displayed fields are required to be filled out by registrants.","example":true}}}},"approve_type":{"type":"integer","description":"Approval type for the registration.","example":0,"enum":[0,1],"x-enum-descriptions":["Automatically approve .","Manually approve"]},"custom_questions":{"type":"array","description":"Array of Registrant Custom Questions","items":{"type":"object","properties":{"title":{"type":"string","description":"Title of the custom question.","example":"true"},"type":{"type":"string","description":"Type of the question being asked.","example":"single_dropdown","enum":["short","single_dropdown","single_radio","multiple"],"x-enum-descriptions":["Short Text","Single Choice Dropdown","Single Choice Radio","Multiple Choice"]},"required":{"type":"boolean","description":"Decide whether this field are required.","example":true},"selected":{"type":"boolean","description":"Indicates whether or not the custom question is required to be answered by participants or not.","example":true},"answers":{"type":"array","description":"Answer choices for the custom question. Can not be used for `short` question type as this type of question requires registrants to type out the answer.","items":{"type":"string","example":"option 1"}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n Missing parameters: type.
\n**Error Code:** `300`
\n Invalid parameter: type.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n Group does not exist: {groupId}.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:read:admin","group:write:admin","group:read:registration_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Read"],"x-macro-scopes":["group:read:admin","group:write:admin"],"x-granular-scopes":["group:read:registration_settings:admin"]}},"patch":{"tags":["Groups"],"summary":"Update a group's webinar registration settings","description":"Update webinar registration settings for a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-).<p style="background-color:#FEEFB3; color:#9F6000"> \n Note:</b> The `force_pmi_jbh_password` field under meeting settings is planned to be deprecated on September 22, 2019. This field will be replaced by another field that will provide the same functionality.</p>\n**Prerequisite**: Pro, Business, or Education account \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:update:registration_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"groupSettingsRegistrationUpdate","parameters":[{"name":"groupId","in":"path","description":"The group ID. Retrieve by calling the List groups API.","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}},{"name":"type","in":"query","description":"The registration type: \n* `webinar` — webinar.","required":false,"schema":{"type":"string","example":"webinar","enum":["webinar"],"x-enum-descriptions":["webinar"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"host_email_notification":{"type":"boolean","description":"Send an email to host when someone registers.","example":true},"close_registration":{"type":"boolean","description":"Close registration after event date.","example":true},"allow_participants_to_join_from_multiple_devices":{"type":"boolean","description":"Allow participants to join from multiple devices","example":true},"show_social_share_buttons":{"type":"boolean","description":"Show social share buttons on registration page","example":true}},"description":"When participants submit registration, do something."},"questions":{"type":"array","description":"Array of Registrant Questions.","items":{"type":"object","properties":{"field_name":{"type":"string","description":"Field name of the question.","example":"last_name","enum":["last_name","address","city","country","zip","state","phone","industry","org","job_title","purchasing_time_frame","role_in_purchase_process","no_of_employees","comments"],"x-enum-descriptions":["Last Name","Address","City","Country/Region","Zip/Postal Code","State/Province","Phone","Industry","Organization","Job Title","Purchasing Time Frame","Role in Purchase Process","Number of Employees","Questions & Comments"]},"required":{"type":"boolean","description":"Decide whether this field are required.","example":true},"selected":{"type":"boolean","description":"Indicates whether or not the displayed fields are required to be filled out by registrants.","example":true}}}},"approve_type":{"type":"integer","description":"Approval type for the registration.","example":0,"enum":[0,1],"x-enum-descriptions":["Automatically approve .","Manually approve"]},"custom_questions":{"type":"array","description":"Array of Registrant Custom Questions","items":{"type":"object","properties":{"title":{"type":"string","description":"Title of the custom question.","example":"true"},"type":{"type":"string","description":"Type of the question being asked.","example":"single_dropdown","enum":["short","single_dropdown","single_radio","multiple"],"x-enum-descriptions":["Short Text","Single Choice Dropdown","Single Choice Radio","Multiple Choice"]},"required":{"type":"boolean","description":"Decide whether this field are required.","example":true},"selected":{"type":"boolean","description":"Indicates whether or not the custom question is required to be answered by participants or not.","example":true},"answers":{"type":"array","description":"Answer choices for the custom question. Can not be used for `short` question type as this type of question requires registrants to type out the answer.","items":{"type":"string","example":"option 1"}}}}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nSettings updated successfully."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only available for Paid account.
\n**Error Code:** `300`
\n Missing parameters: type.
\n**Error Code:** `300`
\n Invalid parameter: type.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n Group does not exist: {groupId}.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:update:registration_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:update:registration_settings:admin"]}}},"/groups/{groupId}/settings/virtual_backgrounds":{"post":{"tags":["Groups"],"summary":"Upload Virtual Background files","description":"Use this API to [upload Virtual Background files](https://support.zoom.us/hc/en-us/articles/210707503-Virtual-Background#h_01EJF3YFEWGT8YA0ZJ079JEDQE) for all users in a group to use. \n\n **Prerequisites:** \n* The [Virtual Background feature](https://support.zoom.us/hc/en-us/articles/210707503-Virtual-Background#h_2ef28080-fce9-4ac2-b567-dc958afab1b7) must be enabled on the account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:virtual_background_files:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"uploadGroupVB","parameters":[{"name":"groupId","in":"path","description":"The group ID. To get a group's ID, use the [**List groups**](/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"The Virtual Background file's path.","example":"binary"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \n Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The file's ID.","example":"6SEYvTU4SuG257lOHuJKOQ"},"is_default":{"type":"boolean","description":"Whether the file is the default Virtual Background file.","example":true},"name":{"type":"string","description":"The file's name.","example":"San Francisco"},"size":{"type":"integer","description":"The file's size, in bytes.","example":7221},"type":{"type":"string","description":"The file type.","example":"image"}},"description":"Information about the Virtual Background file."}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `120`
\n No file uploaded, verify that a file has been uploaded.
\nFile size cannot exceed 15M.
\nA maximum of 10 files are allowed for a user.
\nOnly jpg/jpeg or png image file can be uploaded.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User not exist.
\nUser {email} not exist or not belong to this account.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:write:virtual_background_files:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:write:virtual_background_files:admin"]}},"delete":{"tags":["Groups"],"summary":"Delete Virtual Background files","description":"Use this API to delete a group's [Virtual Background files](https://support.zoom.us/hc/en-us/articles/210707503-Virtual-Background#h_01EJF3YFEWGT8YA0ZJ079JEDQE). \n\n **Prerequisites:** \n* The [Virtual Background feature](https://support.zoom.us/hc/en-us/articles/210707503-Virtual-Background#h_2ef28080-fce9-4ac2-b567-dc958afab1b7) must be enabled on the account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `group:delete:virtual_background_files:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"delGroupVB","parameters":[{"name":"groupId","in":"path","description":"The group ID. To get a group's ID, use the [**List groups**](/api-reference/zoom-api/methods#operation/groups) API.","required":true,"schema":{"type":"string","example":"0mgThLiRQH2bUHvIaL4t2g"}},{"name":"file_ids","in":"query","description":"A comma-separated list of the file IDs to delete.","required":false,"schema":{"type":"string","example":"6SEYvTU4SuG257lOHuJKOQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \n* No content. \n* Deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n * Invalid parameter: {file_ids} \n* Group member not found.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n A group with this {groupId} does not exist.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["group:write:admin","group:delete:virtual_background_files:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["Group:Edit"],"x-macro-scopes":["group:write:admin"],"x-granular-scopes":["group:delete:virtual_background_files:admin"]}}},"/users":{"get":{"tags":["Users"],"summary":"List users","description":"Retrieve a list of your account's users. \n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:list_users:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"users","parameters":[{"name":"status","in":"query","description":"The user's status. \n* `active` - The user exists on the account. \n* `inactive` - The user has been deactivated. \n* `pending` - The user exists on the account, but has not activated their account. See [Managing users](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0061789) for details.\n\nThis value defaults to `active`.","required":false,"schema":{"type":"string","example":"active","default":"active","enum":["active","inactive","pending"]}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":2000,"type":"integer","example":30,"default":30}},{"name":"role_id","in":"query","description":"The role's unique ID. Use this parameter to filter the response by a specific role. You can use the [**List roles**](/docs/api/accounts/#tag/roles/GET/roles) API to get a role's unique ID value.","required":false,"schema":{"type":"string","example":"0"}},{"name":"page_number","in":"query","description":"The page number of the current page in the returned records. We will no longer support this field in a future release. Instead, use the next_page_token for pagination.","required":false,"schema":{"type":"string","example":"1","deprecated":true}},{"name":"include_fields","in":"query","description":"This parameter displays one of the following attributes in the API call's response: \n* `custom_attributes` — Return the user's custom attributes. \n* `host_key` — Return the user's [host key](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067063).","required":false,"schema":{"type":"string","example":"custom_attributes","enum":["custom_attributes","host_key"]}},{"name":"next_page_token","in":"query","description":"The next page token paginates through a large set of results. It returns whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}},{"name":"license","in":"query","description":"The user's license. Filter the response by a specific license.","required":false,"schema":{"type":"string","example":"zoom_workforce_management","enum":["zoom_workforce_management","zoom_compliance_management","zoom_compliance_manager_for_contact_center"]}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nUser list returned.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token paginates through a large set of results. A next page token returns whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"8V8HigQkzm2O5r9RUn31D9ZyJHgrmFfbLa2"},"page_count":{"type":"integer","description":"The number of pages returned for the request made.","example":100},"page_number":{"type":"integer","description":"The page number of the current results.","example":1,"default":1},"page_size":{"maximum":2000,"type":"integer","description":"The number of records returned within a single API call.","example":30,"default":30},"total_records":{"type":"integer","description":"The total number of all the records available across pages.","example":8482},"users":{"maxItems":2000,"type":"array","description":"The information about the users.","items":{"required":["email","type"],"type":"object","properties":{"user_created_at":{"type":"string","description":"The date and time when this user was created.","format":"date-time","example":"2019-06-01T07:58:03Z"},"created_at":{"type":"string","description":"The date and time when this user's latest login type was created.","format":"date-time","example":"2018-10-31T04:32:37Z","deprecated":true},"custom_attributes":{"type":"array","description":"The information about the user's custom attributes.\n\nThis field is **only** returned if users are assigned custom attributes and you provided the `custom_attributes` value for the `include_fields` query parameter in the API request.","items":{"type":"object","properties":{"key":{"type":"string","description":"The custom attribute's unique ID.","example":"cbf_cywdkexrtqc73f97gd4w6g"},"name":{"type":"string","description":"The custom attribute's name.","example":"A1"},"value":{"type":"string","description":"The custom attribute's value.","example":"2323"}}}},"dept":{"type":"string","description":"The user's department.","example":"Developers"},"email":{"type":"string","description":"The user's email address.","format":"email","example":"jchill@example.com"},"employee_unique_id":{"type":"string","description":"The employee's unique ID. The this field only returns when: \n* SAML single sign-on (SSO) is enabled. \n* The `login_type` value is `101` (SSO).","example":"HqDyI037Qjili1kNsSIrIg"},"first_name":{"maxLength":64,"type":"string","description":"The user's first name.","example":"Jill"},"group_ids":{"type":"array","description":"The IDs of groups where the user is a member.","items":{"type":"string","example":"t-_-d56CSWG-7BF15LLrOw"}},"division_ids":{"type":"array","description":"List of division IDs the user belongs to. Currently, only a single division is supported.","items":{"type":"string","example":"xxxxxxxxxx"}},"host_key":{"type":"string","description":"The user's [host key](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067063).\n\nThis field is **only** returned if users are assigned a host key and you provided the `host_key` value for the `include_fields` query parameter in the API request.","example":"299492849"},"id":{"type":"string","description":"The user's ID. \n\nThe API does **not** return this value for users with the `pending` status.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"im_group_ids":{"type":"array","description":"The IDs of IM directory groups where the user is a member.","items":{"type":"string","example":"t-_-d56CSWG-7BF15LLrOw"}},"last_client_version":{"type":"string","description":"The last client version that user used to log in.","example":"5.2.45120.0906(win)"},"last_login_time":{"type":"string","description":"The user's last login time. This field has a three-day buffer period.\n\nFor example, if user first logged in on `2020-01-01` and then logged out and logged in on `2020-01-02`, this value will still reflect the login time of `2020-01-01`. However, if the user logs in on `2020-01-04`, the value of this field will reflect the corresponding login time since it exceeds the three-day buffer period.","format":"date-time","example":"2022-03-25T05:40:55Z"},"last_name":{"maxLength":64,"type":"string","description":"The user's last name.","example":"Chill"},"plan_united_type":{"type":"string","description":"This field is returned if the user is enrolled in the [Zoom United](https://zoom.us/pricing) plan. The license option: \n* `1` — Zoom United Pro-United with US/CA Unlimited. \n* `2` — Zoom United Pro-United with UK/IR Unlimited. \n* `4` — Zoom United Pro-United with AU/NZ Unlimited. \n* `8` — Zoom United Pro-United with Global Select. \n* `16` — Zoom United Pro-United with Zoom Phone Pro. \n* `32` — Zoom United Biz-United with US/CA Unlimited. \n* `64` — Zoom United Biz-United with UK/IR Unlimited. \n* `128` — Zoom United Biz-United with AU/NZ Unlimited. \n* `256` — Zoom United Biz-United with Global Select. \n* `512` — Zoom United Biz-United with Zoom Phone Pro. \n* `1024` — Zoom United Ent-United with US/CA Unlimited. \n* `2048` — Zoom United Ent-United with UK/IR Unlimited. \n* `4096` — Zoom United Ent-United with AU/NZ Unlimited. \n* `8192` — Zoom United Ent-United with Global Select. \n* `16384` — Zoom United Ent-United with Zoom Phone Pro. \n* `32768` — Zoom United Pro-United with JP Unlimited. \n* `65536` — Zoom United Biz-United with JP Unlimited. \n* `131072` — Zoom United Ent-United with JP Unlimited.","example":"1","enum":["1","2","4","8","16","32","64","128","256","512","1024","2048","4096","8192","16384","32768","65536","131072"]},"pmi":{"type":"integer","description":"The user's [personal meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi)","format":"int64","example":6589310093},"role_id":{"type":"string","description":"The unique ID of the user's assigned [role](/docs/api/accounts/#tag/roles/GET/roles).","example":"0"},"status":{"type":"string","description":"The user's status. \n* `active` - An active user. \n* `inactive` - A deactivated user. \n* `pending` - A pending user.","example":"active","enum":["active","inactive","pending"]},"timezone":{"type":"string","description":"The user's timezone.","example":"Asia/Shanghai"},"type":{"type":"integer","description":"The user's assigned plan type. \n* `1` - Basic. \n* `2` - Licensed. \n* `4` - Unassigned without Meetings Basic. \n* `99` - None (this can only be set with `ssoCreate`).","example":1,"enum":[1,2,4,99]},"verified":{"type":"integer","description":"Whether the user's email address for the Zoom account is verified. \n* `1` - A verified user email. \n* `0` - The user's email **not** verified.","example":1,"enum":[1,0]},"display_name":{"maxLength":128,"type":"string","description":"The user's display name.","example":"Jill Chill"},"license_info_list":{"type":"array","description":"Detailed license subscription information. This list is returned only for accounts with multiple subscription plans enabled that contain duplicate plans.","items":{"type":"object","properties":{"license_type":{"type":"string","description":"License type name.\nThe `MEETING` license is associated with the paid user type, while the `ZOOM_WORKPLACE_BUNDLE` license corresponds to the Zoom Workplace series licenses.","example":"ZOOM_WORKPLACE_BUNDLE","enum":["MEETING","ZOOM_WORKPLACE_BUNDLE"]},"license_option":{"type":"integer","description":"License option.\n\nFor the `MEETING` parameter, setting the corresponding value indicates that the user is converted to a licensed user. The specific values are as follows:\nUser's plan type. \n `2` - Licensed. \n\nFor the `ZOOM_WORKPLACE_BUNDLE` parameter, setting the corresponding value assigns the user a Zoom Workplace series license. The specific values are as follows:\nThe user's Zoom Workplace plan option. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited.\n\n The Zoom Workplace plan option for Govermnemt accounts. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus. \n\n The Zoom Workplace plan option for Education accounts. \n `18014398509481984` - Zoom Workplace for Education School and Campus. \n `72057594037927936` - Zoom Workplace for Education Enterprise Essentials. \n `576460752303423488` - Zoom Workplace for Education Enterprise Student. \n `144115188075855872` - Zoom Workplace for Education Enterprise Plus. \n `137438953472` - Zoom Workplace for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` - Zoom Workplace for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom Workplace for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom Workplace for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom Workplace for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom Workplace for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom Workplace for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom Workplace for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom Workplace for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom Workplace for Education Enterprise Premier with Global Select.","example":16,"enum":[2,4,8,16,32,64,128,33554432,134217728,1073741824,536870912,268435456,4398046511104,18014398509481984,72057594037927940,576460752303423500,144115188075855870,137438953472,1099511627776,549755813888,274877906944,2199023255552,4294967296,34359738368,17179869184,8589934592,68719476736]},"subscription_id":{"type":"string","description":"Subscription ID with the corresponding license.","example":"SUBREF-xxxxxx-xxxxxx"}}}},"login_types":{"type":"array","description":"The user's login method.\n\n`0` - Facebook OAuth.\n`1` - Google OAuth.\n`24` - Apple OAuth.\n`27` - Microsoft OAuth.\n`97` - Mobile device.\n`99` - API user.\n`100` - Zoom Work email.\n`101` - Single Sign-On (SSO).","items":{"type":"integer","example":101,"enum":[0,1,23,24,27,97,98,100,101]}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `124`
\n Access token is expired.\nInvalid access token.
\n**Error Code:** `300`
\n The next page token is invalid or expired.
\n**Error Code:** `2300`
\n This API endpoint is not recognized.
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden Access to the Zoom REST API has been denied for this account. Contact Zoom Support for details. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user:read:list_users:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin"],"x-granular-scopes":["user:read:list_users:admin"]}},"post":{"tags":["Users"],"summary":"Create users","description":"Add a new user to your Zoom account. \n\n**Note** These rate limits apply when you use the `create` value for the `action` field. \n* 50 requests per day for **Free** accounts. \n* 1,500 requests per day for **Pro** accounts. \n* 10,000 requests per day for **Business+** accounts. \n\n**Prerequisites** \n* A Pro or higher plan.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:user:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userCreate","requestBody":{"description":"User","content":{"application/json":{"schema":{"required":["action"],"type":"object","properties":{"action":{"type":"string","description":"The action to take to create the new user. \n* `create` - The user receives an email from Zoom containing a confirmation link. The user must then use the link to activate their Zoom account. The user can then set or change their password. \n* `autoCreate` - This action is for Enterprise customers with a managed domain. autoCreate creates an email login type for users. \n* `custCreate` - Users created with this action do not have passwords and will **not** have the ability to log into the Zoom web portal or the Zoom client. These users can still host and join meetings using the `start_url` and `join_url` respectively. To use this option, you must [contact the Integrated Software Vendor (ISV) sales team](https://explore.zoom.us/en/isv/#isv). \n* `ssoCreate` - This action is provided for the enabled “Pre-provisioning SSO User” option. A user created this way has no password. If it is **not** a Basic user, a personal vanity URL with the username (no domain) of the provisioning email is generated. If the username or PMI is invalid or occupied, it uses a random number or random personal vanity URL.","example":"create","enum":["create","autoCreate","custCreate","ssoCreate"]},"user_info":{"required":["email","type"],"type":"object","properties":{"email":{"maxLength":128,"type":"string","description":"User email address.","example":"jchill@example.com"},"first_name":{"maxLength":64,"type":"string","description":"The user's first name. Cannot contain more than 5 Chinese characters.","example":"Jill"},"last_name":{"maxLength":64,"type":"string","description":"The user's last name. Cannot contain more than 5 Chinese characters.","example":"Chill"},"display_name":{"maxLength":128,"type":"string","description":"The user's display name. Cannot contain more than 10 Chinese characters.","example":"Jill Chill"},"password":{"maxLength":32,"minLength":8,"type":"string","description":"User password. Only used for the "autoCreate" function. The password has to have a minimum of 8 characters and maximum of 32 characters. By default (basic requirement), password must have at least one letter (a, b, c..), at least one number (1, 2, 3...) and include both uppercase and lowercase letters. It should not contain only one identical character repeatedly ('11111111' or 'aaaaaaaa') and it cannot contain consecutive characters ('12345678' or 'abcdefgh').\n\n**Note:** If the account owner or admin has enabled [enhanced password requirements](https://support.zoom.us/hc/en-us/articles/360034675592-Advanced-security-settings#h_fa9186e4-6818-4f7a-915c-2e25c19f0acd), the value provided in this field must meet those requirements. These requirements can be retrieved by calling the [**Get account settings**](/docs/api-reference/zoom-api/ma#operation/accountSettings) API and referring to the `password_requirement` field present in the `security` object.","format":"password","example":"if42!LfH@"},"type":{"type":"integer","description":"User type. \n `1` - Basic. \n `2` - Licensed. \n `4` - Unassigned without Meetings Basic. \n `99` - None. this can only be set with `ssoCreate`.","example":1,"enum":[1,2,4,99]},"division_ids":{"maxItems":1,"type":"array","description":"List of Division IDs to be updated (currently only a single division is supported)","items":{"type":"string","example":"xxxxxxxxxx"}},"feature":{"type":"object","properties":{"zoom_phone":{"type":"boolean","description":"Whether the user has the **Zoom Phone** feature enabled.","example":true},"zoom_one_type":{"type":"integer","description":"The Zoom Workplace plan option. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited. \n \n The Zoom One plan option for Gov accounts: \n `16` - Zoom One Business Plus. \n \n The Zoom One plan option for Education accounts: \n `18014398509481984` - Zoom One for Education School and Campus. \n `72057594037927936` - Zoom One for Education Enterprise Essentials. \n `576460752303423488` - Zoom One for Education Enterprise Student. \n `144115188075855872` - Zoom One for Education Enterprise Plus. \n `137438953472` - Zoom One for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` -Zoom One for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom One for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom One for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom One for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom One for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom One for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom One for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom One for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom One for Education Enterprise Premier with Global Select.","example":64,"enum":[16,32,64,128,33554432,134217728,268435456,536870912,1073741824,4398046511104,4294967296,8589934592,17179869184,34359738368,68719476736,137438953472,274877906944,549755813888,1099511627776,2199023255552,18014398509481984,72057594037927940,144115188075855870,576460752303423500]}},"description":"Information about the user's features."},"plan_united_type":{"type":"string","description":"The Zoom United type. The license option. \n* `1` - Zoom United Pro-United with US/CA Unlimited. \n* `2` - Zoom United Pro-United with UK/IR Unlimited. \n* `4` - Zoom United Pro-United with AU/NZ Unlimited. \n* `8` - Zoom United Pro-United with Global Select. \n* `16` - Zoom United Pro-United with Zoom Phone Pro. \n* `32` - Zoom United Biz-United with US/CA Unlimited. \n* `64` - Zoom United Biz-United with UK/IR Unlimited. \n* `128` - Zoom United Biz-United with AU/NZ Unlimited. \n* `256` - Zoom United Biz-United with Global Select. \n* `512` - Zoom United Biz-United with Zoom Phone Pro. \n* `1024` - Zoom United Ent-United with US/CA Unlimited. \n* `2048` - Zoom United Ent-United with UK/IR Unlimited. \n* `4096` - Zoom United Ent-United with AU/NZ Unlimited. \n* `8192` - Zoom United Ent-United with Global Select. \n* `16384` - Zoom United Ent-United with Zoom Phone Pro. \n* `32768` - Zoom United Pro-United with JP Unlimited. \n* `65536` - Zoom United Biz-United with JP Unlimited. \n* `131072` - Zoom United Ent-United with JP Unlimited.","example":"1","enum":["1","2","4","8","16","32","64","128","256","512","1024","2048","4096","8192","16384","32768","65536","131072"]},"license_info_list":{"maxItems":2,"type":"array","description":"A list of license information used to specify the appropriate license type, license option, and license subscription reference ID or name during user creation.","items":{"required":["license_option","license_type","subscription_id"],"type":"object","properties":{"license_type":{"type":"string","description":"License type name.\nThe `MEETING` license is associated with the paid user type, while the `ZOOM_WORKPLACE_BUNDLE` license corresponds to the Zoom Workplace series licenses.","example":"ZOOM_WORKPLACE_BUNDLE","enum":["MEETING","ZOOM_WORKPLACE_BUNDLE"]},"license_option":{"type":"integer","description":"License option.\n\nFor the `MEETING` parameter, setting the corresponding value indicates that the user is converted to a licensed user. The specific values are as follows:\nUser's plan type. \n `2` - Licensed. \n\nFor the `ZOOM_WORKPLACE_BUNDLE` parameter, setting the corresponding value assigns the user a Zoom Workplace series license. The specific values are as follows:\nThe user's Zoom Workplace plan option. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited.\n\n The Zoom Workplace plan option for Govermnemt accounts. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus. \n\n The Zoom Workplace plan option for Education accounts. \n `18014398509481984` - Zoom Workplace for Education School and Campus. \n `72057594037927936` - Zoom Workplace for Education Enterprise Essentials. \n `576460752303423488` - Zoom Workplace for Education Enterprise Student. \n `144115188075855872` - Zoom Workplace for Education Enterprise Plus. \n `137438953472` - Zoom Workplace for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` - Zoom Workplace for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom Workplace for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom Workplace for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom Workplace for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom Workplace for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom Workplace for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom Workplace for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom Workplace for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom Workplace for Education Enterprise Premier with Global Select.\n","example":16,"enum":[2,4,8,16,32,64,128,33554432,134217728,1073741824,536870912,268435456,4398046511104,18014398509481984,72057594037927940,576460752303423500,144115188075855870,137438953472,1099511627776,549755813888,274877906944,2199023255552,4294967296,34359738368,17179869184,8589934592,68719476736]},"subscription_id":{"type":"string","description":"The subscription ID associated with the corresponding license.","example":"SUBREF-xxxxxx-xxxxxx"}}}}}}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \nUser created.","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"User email address.","example":"jchill@example.com"},"first_name":{"maxLength":64,"type":"string","description":"The user's first name.","example":"Jill"},"id":{"type":"string","description":"User ID.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"last_name":{"maxLength":64,"type":"string","description":"The user's last name.","example":"Chill"},"type":{"type":"integer","description":"User type. \n `1` - Basic. \n `2` - Licensed. \n `4` - Unassigned without Meetings Basic. \n `99` - None. This can only be set with `ssoCreate`.\n","example":1,"enum":[1,2,4,99]}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n Invalid parameter: password\n Your account can't set user type as On-prem.
\n**Error Code:** `200`
\n No privilege.
No permission.
Invalid access token. Does not contain permissions [User:Edit].
\n**Error Code:** `1000`
\n The user cannot be changed because they are a Call-queue manager or Auto-receptionist operator.
\n**Error Code:** `300`
\n * Your request could not be completed because the name contains an invalid word: `{name}`.
The value provided for `plan_united_type` parameter is invalid. Try again with a valid value.\n* The subscription \"{subscriptionId}\" you entered does not exist. Please choose a different subscription and try again.
\n**Error Code:** `1009`
\n The user $email already holds an active account.
\n**Error Code:** `1107`
\n Email domain is blocked.
\n**Error Code:** `2034`
\n Your request to add a new {0} user could not be approved at this time because your account has reached the permitted maximum number of {1} users. Please purchase additional licenses or contact the Zoom support team to provision additional users in your account.
\n**Error Code:** `2033`
\n Your request to add a basic user wasn't approved because you've already reached the maximum basic user limit allowed in your account. For additional help regarding this issue, contact the Zoom Customer Support team.
\n**Error Code:** `3412`
\n * Your request to add a basic user couldn't be approved at this time because your account has reached the permitted maximum number of $maxAllowedNumber basic users. Please remove existing basic user(s) from your Users list or the Pending Users list before attempting to add another user. \n* Your request to add a new \"{$userType}\" user couldn't be approved at this time because your account has reached the permitted maximum number of \"{$maxAllowedNumber}\" paying users. Please purchase additional licenses or contact the Zoom support team to provision additional users in your account.\n* Your request to add a new \"{$userType}\" user could not be approved at this time because the subscription {$subscriptionId} has reached the permitted maximum number of \"{$maxAllowedNumber}\" paying users. Please choose a different subscription and try again.
\n**Error Code:** `1108`
\n Permission requirements to change the user type of this user were not met.
\n**Error Code:** `1116`
\n Email address $email doesn't match limited domains: $domains
\n**Error Code:** `2002`
\n SSO has not been enabled for this account. Contact the Zoom support team to enable this option.
\n**Error Code:** `2032`
\n The ssoCreate option is only available for SSO Partners that have enabled the pre-provision option. Contact the Zoom Support team to learn more.
\n**Error Code:** `2035`
\n GPA accounts cannot add users.
\n**Error Code:** `2036`
\n Other accounts cannot invite GPA account owners.
\n**Error Code:** `2037`
\n Force forbidden user can not be invited.
\n**Error Code:** `2038`
\n * Your request to add a new Zoom One user could not be approved at this time because your account has reached the permitted maximum number. Please purchase additional licenses or contact the Zoom support team to provision additional users in your account.\n* Your request to add a new Zoom One user could not be approved at this time because the subscription \"{subscriptionId}\" doesn’t have enough licenses available to assign. Please choose a different subscription and try again.
\n**Error Code:** `11321`
\n Email domain is blocked by Zoom Trust & Safety.
\n**Error Code:** `2016`
\n No permission. Please contact Zoom Customer Support.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `4130`
\n Group does not exist: $groupId.
\n**Error Code:** `1102`
\n You cannot enable the **Zoom Phone** feature because you do not have any available licenses.
\n"},"409":{"description":"**HTTP Status Code:** `409`
\n Conflict \n\n **Error Code:** `1005`
\n Email \"$email\" has already been used.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write","user:write:admin","user:write:user:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write","user:write:admin"],"x-granular-scopes":["user:write:user:admin"]}}},"/users/email":{"get":{"tags":["Users"],"summary":"Check a user email","description":"Verify if a user's email is registered with Zoom. \n \n \n\n<b>Note: </b>You can successfully check if a user is a registered Zoom user only if the user **signed up for Zoom via email and is within your account.** If you provide an email address of a user who is not in your account, the value of "existed_email" parameter will be "false" irrespective of whether or not the user is registered with Zoom. The response of this API call will not include users who joined Zoom using options such as "Sign in with SSO", "Sign in with Google" or "Sign in with Facebook" even if they are in the same account as yours.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:email`,`user:read:email:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userEmail","parameters":[{"name":"email","in":"query","description":"The email address to be verified.","required":true,"schema":{"type":"string","example":"jchill@example.com"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nSuccess.","content":{"application/json":{"schema":{"type":"object","properties":{"existed_email":{"type":"boolean","description":"Indicates whether or not the email already exists in Zoom.","example":true}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request\n\n**Error Code:** `300`
\nEmail is required.\n\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found\n\n**Error Code:** `1001`
\nUser does not exist: $userId.\n\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user:read:email","user:read:email:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin"],"x-granular-scopes":["user:read:email","user:read:email:admin"]}}},"/users/features":{"post":{"tags":["Users"],"summary":"Bulk update features for users","description":"Update multiple features for a user. \n\n**Note** This endpoint can process a maximum of 30 users at a time. Furthermore, the endpoint is rate-limited to one request every 10 seconds.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:feature:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"bulkUpdateFeature","requestBody":{"description":"User feature","content":{"application/json":{"schema":{"required":["feature_type","feature_value","users"],"type":"object","properties":{"feature_type":{"type":"string","description":"The feature type to update.","example":"user_type","enum":["user_type","concurrent_meeting","large_meeting","webinar","zoom_events","zoom_whiteboard","plan_united_type","zoom_one_type","zoom_iq_for_sales","zoom_revenue_accelerator","zoom_clips_plus"]},"feature_value":{"type":"string","description":"The feature value to update. The value you can pass depends on the 'feature_type' field. \n\n**user_type:** \n* `1` - Basic \n* `2` - Licensed \n* `99` - None. This can only be set with `ssoCreate`. \n\n**concurrent_meeting:** \n* `Basic` \n* `Plus` \n* `None`. \n\n**large_meeting:** \n* `1` - 100 capacity \n* `32` - 200 capacity\n* `64` - 300 capacity\n* `128` - 500 capacity\n* `256` - 1000 capacity \n* `1024` - 3000 capacity\n* `2048` - 5000 capacity\n* `0` - Turn off the **Large meeting** feature. \n\n**webinar:** \n* `16` - 100 capacity \n* `1` - 500 capacity \n* `64` - 1000 capacity \n* `128` - 3000 capacity\n* `256` - 5000 capacity \n* `512` - 10000 capacity \n* `1024` - 20000 capacity \n* `2048` - 30000 capacity \n* `4096` - 40000 capacity \n* `8192` - 50000 capacity \n* `16384` - promo 500 capacity \n* `32768` - promo 1000 capacity \n* `0` - Turn off the **Webinar** feature. \n\n**zoom_events:** \n* `500` - 500 capacity \n* `1000` - 1000 capacity \n* `3000` - 3000 capacity \n* `5000` - 5000 capacity \n* `10000` - 10000 capacity \n* `20000` - 20000 capacity \n* `30000` - 30000 capacity \n* `50000` - 50000 capacity \n* `0` - Turn off the **Zoom events** feature. \n\n**zoom_iq_for_sales:** \n* `true` - Turn on the **Zoom Revenue Accelerator** feature. \n* `false` - Turn off the **Zoom Revenue Accelerator** feature. \n\n**zoom_revenue_accelerator:** \n* `true` - Turn on the **Zoom Revenue Accelerator** feature. \n* `false` - Turn off the **Zoom Revenue Accelerator** feature. \n\n**zoom_whiteboard:** \n* `true` - Turn on the **Zoom whiteboard** feature. \n* `false` - Turn off the **Zoom whiteboard** feature. \n\n**zoom_clips_plus** \n* `true` - Turn on the **Zoom Clips Plus** feature. \n* `false` - Turn off the **Zoom Clips Plus** feature. \n\n**plan_united_type:** \n* `1` - Zoom United Pro-United with US/CA Unlimited. \n* `2` - Zoom United Pro-United with UK/IR Unlimited. \n* `4` - Zoom United Pro-United with AU/NZ Unlimited. \n* `8` - Zoom United Pro-United with Global Select. \n* `16` - Zoom United Pro-United with Zoom Phone Pro. \n* `32` - Zoom United Biz-United with US/CA Unlimited. \n* `64` - Zoom United Biz-United with UK/IR Unlimited. \n* `128` - Zoom United Biz-United with AU/NZ Unlimited. \n* `256` - Zoom United Biz-United with Global Select. \n* `512` - Zoom United Biz-United with Zoom Phone Pro. \n* `1024` - Zoom United Ent-United with US/CA Unlimited. \n* `2048` - Zoom United Ent-United with UK/IR Unlimited. \n* `4096` - Zoom United Ent-United with AU/NZ Unlimited. \n* `8192` - Zoom United Ent-United with Global Select. \n* `16384` - Zoom United Ent-United with Zoom Phone Pro. \n* `32768` - Zoom United Pro-United with JP Unlimited. \n* `65536` - Zoom United Biz-United with JP Unlimited. \n* `131072` - Zoom United Ent-United with JP Unlimited. \n* `0` - Turn off the **Zoom united** feature. \n\n**zoom_one_type:** \n* `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n* `32` - Zoom Workplace Business Plus with UK/Ireland Unlimited. \n* `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n* `128` - Zoom Workplace Business Plus with Japan Unlimited. \n* `33554432` - Zoom Workplace Business Plus with Global Select. \n* `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n* `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n* `536870912` - Zoom Workplace Enterprise Premier with UK/Ireland Unlimited. \n* `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n* `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited. \n* `0` - Turn off the **Zoom Workplace** feature. \n\nFor Gov accounts: \n* `16` - Zoom One Business Plus. \n* `0` - Turn off the **Zoom one** feature. \n\nFor Education accounts: \n* `18014398509481984` - Zoom One for Education School and Campus. \n* `72057594037927936` - Zoom One for Education Enterprise Essentials. \n* `576460752303423488` - Zoom One for Education Enterprise Student. \n* `144115188075855872` - Zoom One for Education Enterprise Plus. \n* `137438953472` - Zoom One for Education School and Campus Plus with US/CA Unlimited. \n* `1099511627776` -Zoom One for Education School and Campus Plus with AU/NZ Unlimited. \n* `549755813888` - Zoom One for Education School and Campus Plus with UK/Ireland Unlimited. \n* `274877906944` - Zoom One for Education School and Campus Plus with Japan Unlimited. \n* `2199023255552` - Zoom One for Education School and Campus Plus with Global Select. \n* `4294967296` - Zoom One for Education Enterprise Premier with US/CA Unlimited. \n* `34359738368` - Zoom One for Education Enterprise Premier with AU/NZ Unlimited. \n* `17179869184` -Zoom One for Education Enterprise Premier with UK/Ireland Unlimited. \n* `8589934592` - Zoom One for Education Enterprise Premier with with Japan Unlimited. \n* `68719476736` - Zoom One for Education Enterprise Premier with Global Select. \n* `0` - Turn off the **Zoom one** feature.","example":"1"},"subscription_id":{"type":"string","description":"The subscription ID associated with the corresponding license. For accounts with duplicate subscription IDs, when zoom_one_type is 0, this parameter represents the subscription ID that requires the allocation of a meeting license.","example":"SUBREF-xxxxxx-xxxxxx"},"users":{"maxItems":30,"type":"array","description":"The users' information to update.","items":{"type":"object","properties":{"id":{"type":"string","description":"The user's ID.","example":"-gbbm4KGTsSvL5zmELDJdw"},"email":{"type":"string","description":"The user's email.","example":"jchill@example.com"}}}},"license_info_list":{"maxItems":2,"type":"array","description":"A list of license information used to specify the appropriate license type, license option, and license subscription reference ID or name during user creation.","deprecated":true,"items":{"required":["license_option","license_type","subscription_id"],"type":"object","properties":{"license_type":{"type":"string","description":"License type name.\nThe `MEETING` license is associated with the paid user type, while the `ZOOM_WORKPLACE_BUNDLE` license corresponds to the Zoom Workplace series licenses.","example":"ZOOM_WORKPLACE_BUNDLE","deprecated":true,"enum":["MEETING","ZOOM_WORKPLACE_BUNDLE"]},"license_option":{"type":"integer","description":"License option.\n\nFor the `MEETING` parameter, setting the corresponding value indicates that the user is converted to a licensed user. The specific values are as follows:\nUser's plan type. \n `2` - Licensed. \n\nFor the `ZOOM_WORKPLACE_BUNDLE` parameter, setting the corresponding value assigns the user a Zoom Workplace series license. The specific values are as follows:\nThe user's Zoom Workplace plan option. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited.\n\nThe Zoom Workplace plan option for Govermnemt accounts. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus. \n\nThe Zoom Workplace plan option for Education accounts. \n `18014398509481984` - Zoom Workplace for Education School and Campus. \n `72057594037927936` - Zoom Workplace for Education Enterprise Essentials. \n `576460752303423488` - Zoom Workplace for Education Enterprise Student. \n `144115188075855872` - Zoom Workplace for Education Enterprise Plus. \n `137438953472` - Zoom Workplace for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` - Zoom Workplace for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom Workplace for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom Workplace for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom Workplace for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom Workplace for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom Workplace for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom Workplace for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom Workplace for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom Workplace for Education Enterprise Premier with Global Select.","example":16,"deprecated":true,"enum":[2,4,8,16,32,64,128,33554432,134217728,1073741824,536870912,268435456,4398046511104,18014398509481984,72057594037927940,576460752303423500,144115188075855870,137438953472,1099511627776,549755813888,274877906944,2199023255552,4294967296,34359738368,17179869184,8589934592,68719476736]},"subscription_id":{"type":"string","description":"The subscription ID associated with the corresponding license.","example":"SUBREF-xxxxxx-xxxxxx","deprecated":true}}}}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \nFeatures updated.","content":{"application/json":{"schema":{"type":"object","properties":{"success_user_ids":{"maxItems":30,"type":"array","description":"The IDs of users for whom the feature was updated successfully","items":{"type":"string","example":"-gbbm4KGTsSvL5zmELDJdw"}},"fail_details":{"maxItems":30,"type":"array","description":"The details why these users' feature was not updated successfully.","items":{"type":"object","properties":{"user_ids":{"maxItems":30,"type":"array","description":"The IDs of users for whom the feature was not updated successfully.","items":{"type":"string","example":"-gbbm4KGTsSvL5zmELDJdw"}},"reason":{"type":"string","description":"The reason why the feature for these users was not updated successfully.","example":"Not enough seats","enum":["Users not found","Have upcoming events","Unpaid user","Not enough seats","Can't update for Zoom One users","Can't update for free users","Can't update for Zoom United users","Can't update for Zoom Room users","Not allowed to add basic users","Can't update for non-SSO users","No need to update"]}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n * Current account must be a paid account. \n* Current account does not enable this feature.
\n**Error Code:** `300`
\n * Your account can't set user type as On-prem.\n* The subscription \"{subscriptionId}\" you entered does not exist. Please choose a different subscription and try again.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write","user:write:admin","user:write:feature:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write","user:write:admin"],"x-granular-scopes":["user:write:feature:admin"]}}},"/users/me/zak":{"get":{"tags":["Users"],"summary":"Get the user's ZAK","description":"Get the Zoom Access Key (ZAK) for the authenticated user associated with the access token in the API request. Use a ZAK to start or join a meeting on behalf of this user.\n\nZAKs obtained with this endpoint expire five minutes after receipt.\n\nTo get a ZAK for a different user or with a different expiration, use the [Get a user token](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods#operation/userToken) API with the `zak` `type` query parameter.\n\nSee [Getting a Zoom Access Key (ZAK)](https://developers.zoom.us/docs/meeting-sdk/auth/#start-meetings-and-webinars-with-a-zoom-users-zak-token) for details.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user_zak:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:zak`,`user:read:zak:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userZak","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"The user's ZAK.","example":"eyJ0eXAiOiJKV1QiLCJzdiI6IjAwMDAwMSIsInptX3NrbSI6InptX28ybSIsImFsZyI6IkhTMjU2In0.eyJhdWQiOiJjbGllbnRzbSIsInVpZCI6Im4ya1NtRmdsU2lpRnZjZWJFZTVWRFEiLCJpc3MiOiJ3ZWIiLCJzayI6IjAiLCJzdHkiOjk5LCJ3Y2QiOiJkZXYiLCJjbHQiOjAsImV4cCI6MTY1NzQ0MjI4MSwiaWF0IjoxNjQ5NjY2MjgxddkFMiiOiI0YUZaXzRJa1QzV05LMjMtSFZWSlFnIiwiY2lkIjoiIn0.RmCpEOQVUFXhtEyAaR5UsgEuAUKckcWnfWVMkH-XVGc"}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `1001`
\n User not exist.
\nUser {userId} does not exist or does not belong to this account.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user_zak:read","user:read:zak","user:read:zak:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user_zak:read"],"x-granular-scopes":["user:read:zak","user:read:zak:admin"]}}},"/users/summary":{"get":{"tags":["Users"],"summary":"Get user summary","description":"Gets a summary of users, including the number and types of users in the account.\n\n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:summary:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"userSummary","responses":{"200":{"description":"**HTTP Status Code:** `200` \n User summary returned.","content":{"application/json":{"schema":{"type":"object","properties":{"licensed_users_count":{"type":"integer","description":"The number of licensed users.","example":30},"basic_users_count":{"type":"integer","description":"The number of basic users.","example":30},"on_prem_users_count":{"type":"integer","description":"The number of on-prem users.","example":30},"room_users_count":{"type":"integer","description":"The number of Zoom rooms.","example":30},"pending_users_count":{"type":"integer","description":"The number of users with a pending activation meeting license.","example":30},"join_only_users_count":{"type":"integer","description":"The number of users without licenses.","example":30},"total_users_count":{"type":"integer","description":"The total number of `licensed_users_count`, `basic_users_count`, `on_prem_users_count`, `join_only_users_count` and `room_users_count`.","example":120}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `124`
\n Access token is expired. Invalid access token.
\n**Error Code:** `2300`
\n This API endpoint is not recognized.
\n"},"403":{"description":"**HTTP Status Code:** `403`
\n Forbidden Access to the Zoom REST API has been denied for this account. Contact Zoom Support for details. \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user:read:summary:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin"],"x-granular-scopes":["user:read:summary:admin"]}}},"/users/vanity_name":{"get":{"tags":["Users"],"summary":"Check a user's PM room","description":"A personal meeting room is a virtual meeting room that can be permanently assigned to a user.\nUse this API to check if a personal meeting room with the given name exists or not. \n \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:pm_room`,`user:read:pm_room:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userVanityName","parameters":[{"name":"vanity_name","in":"query","description":"Personal meeting room name.","required":true,"schema":{"type":"string","example":"Jill"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nSuccess.","content":{"application/json":{"schema":{"type":"object","properties":{"existed":{"type":"boolean","description":"If `true`, it indicates that the personal meeting room with the given name exists. \n `false` - The room name does not exist.","example":false}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request\n\n**Error Code:** `300`
\nVanity name is required.\n\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user:read:pm_room","user:read:pm_room:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin"],"x-granular-scopes":["user:read:pm_room","user:read:pm_room:admin"]}}},"/users/{userId}":{"get":{"tags":["Users"],"summary":"Get a user","description":"View a user's information on a Zoom account. For user-managed apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter. \r\n**Note:** The `user_info:read` scope is only available when you pass the `me` value for the `$userId` value. \r\n\r\nUsers who have not activated their account will have a `pending` status. These users' `created_at` timestamp will also display the time at which the API call was made, **not** the account's creation date. \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`,`user_profile`,`user_info:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:user`,`user:read:user:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"user","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"login_type","in":"query","description":"The user's login method. \n* `0` - Facebook OAuth \n* `1` - Google OAuth. \n* `24` - Apple OAuth. \n* `27` - Microsoft OAuth. \n* `97` - Mobile device. \n* `98` - RingCentral OAuth. \n* `99` - API user. \n* `100` - Zoom Work email. \n* `101` - Single Sign-On (SSO). \n\nThese login methods are only available in China. \n* `11` - Phone number. \n* `21` - WeChat. \n* `23` - Alipay.","required":false,"schema":{"type":"integer","example":101,"enum":[0,1,11,21,23,24,27,97,98,99,100,101]}},{"name":"encrypted_email","in":"query","description":"Whether the email address passed for the `userId` value is an encrypted email address. \n\n * `true` - The email address is encrypted. \n * `false` - The email address is not encrypted. \n\n If you do not query this parameter, this value defaults to null (`false`).","required":false,"schema":{"type":"boolean","example":false,"default":false}},{"name":"search_by_unique_id","in":"query","description":"Whether the queried `userId` value is an employee unique ID. \n* `true` - The queried ID is an employee's unique ID. \n* `false` - The queried ID is not an employee's unique ID. \n\nThis value defaults to `false` (null).","required":false,"schema":{"type":"boolean","example":true}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK** \n \nUser object returned.","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"id":{"type":"string","description":"User ID.","example":"zJKyaiAyTNC-MWjiWC18KQ"}}},{"required":["type"],"type":"object","properties":{"created_at":{"type":"string","description":"User create time.","format":"date-time","example":"2018-10-31T04:32:37Z"},"dept":{"type":"string","description":"Department.","example":"Developers"},"email":{"type":"string","description":"User's email address.","example":"jchill@example.com"},"first_name":{"maxLength":64,"type":"string","description":"User's first name.","example":"Jill"},"last_client_version":{"type":"string","description":"User last login client version.","example":"5.9.6.4993(mac)"},"last_login_time":{"type":"string","description":"User last login time.","format":"date-time","example":"2021-05-05T20:40:30Z"},"last_name":{"maxLength":64,"type":"string","description":"User's last name.","example":"Chill"},"pmi":{"type":"integer","description":"[Personal Meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi).","format":"int64","example":3542471135},"role_name":{"type":"string","description":"User's [role](https://support.zoom.us/hc/en-us/articles/115001078646-Role-Based-Access-Control) name.","example":"Admin"},"timezone":{"type":"string","description":"The time zone of the user.","example":"Asia/Shanghai"},"type":{"type":"integer","description":"User's plan type. \n `1` - Basic. \n `2` - Licensed. \n `4` - Unassigned without Meetings Basic. \n `99` - None. This can only be set with `ssoCreate`.","example":1,"enum":[1,2,4,99]},"use_pmi":{"type":"boolean","description":"Use the [personal meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi) for instant meetings.","example":false,"default":false},"display_name":{"maxLength":128,"type":"string","description":"User's display name.","example":"Jill Chill"}},"description":"The user object represents a specific user on Zoom."},{"type":"object","properties":{"account_id":{"type":"string","description":"User's account ID.","example":"q6gBJVO5TzexKYTb_I2rpg"},"account_number":{"type":"integer","description":"The user's account number.","format":"int64","example":10009239},"cms_user_id":{"type":"string","description":"The user's CMS ID. Only enabled for Kaltura integration.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"company":{"type":"string","description":"The user's company.","example":"Jill"},"created_at":{"type":"string","description":"The date and time when this user's latest login type was created.","format":"date-time","example":"2018-10-31T04:32:37Z","deprecated":true},"user_created_at":{"type":"string","description":"The date and time when this user was created.","format":"date-time","example":"2018-10-31T04:32:37Z"},"custom_attributes":{"type":"array","description":"Custom attributes that have been assigned to the user.","items":{"type":"object","properties":{"key":{"type":"string","description":"The custom attribute's identifier.","example":"cbf_cywdkexrtqc73f97gd4w6g"},"name":{"type":"string","description":"The custom attribute's name.","example":"A1"},"value":{"type":"string","description":"The custom attribute's value.","example":"1"}}}},"employee_unique_id":{"type":"string","description":"The employee's unique ID. This field only returns when \n* SAML single sign-on (SSO) is enabled. \n* The `login_type` value is `101` (SSO). \n","example":"HqDyI037Qjili1kNsSIrIg"},"group_ids":{"type":"array","description":"IDs of the web groups that the user belongs to. ","items":{"type":"string","example":"RSMaSp8sTEGK0_oamiA2_w"}},"division_ids":{"type":"array","description":"List of division IDs the user belongs to. Currently, only a single division is supported.","items":{"type":"string","example":"xxxxxxxxxx"}},"im_group_ids":{"type":"array","description":"IM IDs of the groups that the user belongs to.","items":{"type":"string","example":"t-_-d56CSWG-7BF15LLrOw"}},"jid":{"type":"string","example":"jchill@example.com"},"job_title":{"type":"string","description":"The user's job title.","example":"API Developer"},"cost_center":{"type":"string","description":"The user's cost center.","example":"cost center"},"language":{"type":"string","description":"Default language for the Zoom Web Portal.","example":"en-US"},"location":{"type":"string","description":"The user's location.","example":"Paris"},"login_types":{"type":"array","description":"The user's login method.\n\n`0` - Facebook OAuth.\n`1` - Google OAuth.\n`24` - Apple OAuth.\n`27` - Microsoft OAuth.\n`97` - Mobile device.\n`98` - RingCentral OAuth.\n`99` - API user.\n`100` - Zoom Work email.\n`101` - Single Sign-On (SSO).\n\nThese login methods are only available in China.\n\n`11` - Phone number.\n`21` - WeChat.\n`23` - Alipay.","items":{"type":"integer","example":101,"enum":[0,1,11,21,23,24,27,97,98,99,100,101]}},"manager":{"type":"string","description":"The user's manager.","format":"email","example":"thill@example.com"},"personal_meeting_url":{"type":"string","description":"User's personal meeting URL.","example":"example.com"},"phone_country":{"type":"string","description":"This field has been **deprecated** and will not be supported in the future. Use the **phone_numbers** field instead of this field. \n User's country for the company phone number.","example":"US","deprecated":true},"phone_number":{"type":"string","description":"This field has been **deprecated** and will not be supported in the future. Use the **phone_numbers** field instead of this field.\n The user's phone number.","example":"+1 800000000","deprecated":true},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's ISO country code. For example, United States phone numbers' value will be `+1`.","example":"+1"},"country":{"type":"string","description":"The phone number's [country ID](/docs/api/references/abbreviations/#countries). For example, if the `number` field contains a Brazil-based number, this value is `BR`.","example":"US"},"label":{"type":"string","description":"The phone number's label.\n* `Mobile`\n* `Office`\n* `Home`\n * `Fax`","example":"Mobile","enum":["Mobile","Office","Home","Fax"]},"number":{"type":"string","description":"The user's phone number.","example":"800000000"},"verified":{"type":"boolean","description":"Whether Zoom has verified the phone number.","example":true}}}},"pic_url":{"type":"string","description":"The URL for user's profile picture.","example":"example.com"},"plan_united_type":{"type":"string","description":"This field is returned if the user is enrolled in the [Zoom United](https://zoom.us/pricing/zoom-bundles) plan.\n* `1` - Zoom United Pro-United with US/CA Unlimited. \n* `2` - Zoom United Pro-United with UK/IR Unlimited. \n* `4` - Zoom United Pro-United with AU/NZ Unlimited. \n* `8` - Zoom United Pro-United with Global Select. \n* `16` - Zoom United Pro-United with Zoom Phone Pro. \n* `32` - Zoom United Biz-United with US/CA Unlimited. \n* `64` - Zoom United Biz-United with UK/IR Unlimited. \n* `128` - Zoom United Biz-United with AU/NZ Unlimited. \n* `256` - Zoom United Biz-United with Global Select. \n* `512` - Zoom United Biz-United with Zoom Phone Pro. \n* `1024` - Zoom United Ent-United with US/CA Unlimited. \n* `2048` - Zoom United Ent-United with UK/IR Unlimited. \n* `4096` - Zoom United Ent-United with AU/NZ Unlimited. \n* `8192` - Zoom United Ent-United with Global Select. \n* `16384` - Zoom United Ent-United with Zoom Phone Pro. \n* `32768` - Zoom United Pro-United with JP Unlimited. \n* `65536` - Zoom United Biz-United with JP Unlimited. \n* `131072` - Zoom United Ent-United with JP Unlimited.","example":"1","enum":["1","2","4","8","16","32","64","128","256","512","1024","2048","4096","8192","16384","32768","65536","131072"]},"pronouns":{"type":"string","description":"The user's pronouns.","example":"3123"},"pronouns_option":{"type":"integer","description":"The user's display pronouns setting.\n* `1` - Ask the user every time they join meetings and webinars. \n* `2` - Always display pronouns in meetings and webinars. \n* `3` - Do not display pronouns in meetings and webinars.","example":1,"enum":[1,2,3]},"role_id":{"type":"string","description":"Unique identifier of the user's assigned [role](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/roles).","example":"0"},"status":{"type":"string","description":"Status of user's account.","example":"pending","enum":["pending","active","inactive"],"x-enum-descriptions":["Pending User","Active User","Deactivated User"]},"use_pmi":{"type":"boolean","description":"Displays `true` if user has enabled a [personal meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi) for instant meetings, `false` otherwise.","example":false,"default":false},"vanity_url":{"type":"string","description":"Personal meeting room URL, if the user has one.","example":"example.com"},"verified":{"type":"integer","description":"Displays whether user is verified or not.\n \n`1` - Account verified. \n \n`0` - Account not verified.","example":1},"cluster":{"type":"string","description":"The user's cluster.","example":"us04"},"zoom_one_type":{"type":"integer","description":"The user's Zoom Workplace plan option. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited.\n\n The Zoom One plan option for Govermnemt accounts. \n `4` - Zoom One Enterprise. \n `8` - Zoom One Enterprise Plus. \n `16` - Zoom One Business Plus. \n\n The Zoom One plan option for Education accounts. \n `18014398509481984` - Zoom One for Education School and Campus. \n `72057594037927936` - Zoom One for Education Enterprise Essentials. \n `576460752303423488` - Zoom One for Education Enterprise Student. \n `144115188075855872` - Zoom One for Education Enterprise Plus. \n `137438953472` - Zoom One for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` - Zoom One for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom One for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom One for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom One for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom One for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom One for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom One for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom One for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom One for Education Enterprise Premier with Global Select.","example":64},"license_info_list":{"type":"array","description":"Detailed license subscription information. This list is returned only for accounts with multiple subscription plans enabled that contain duplicate plans.","items":{"type":"object","properties":{"license_type":{"type":"string","description":"License type name.\nThe `MEETING` license is associated with the paid user type, while the `ZOOM_WORKPLACE_BUNDLE` license corresponds to the Zoom Workplace series licenses.","example":"ZOOM_WORKPLACE_BUNDLE","enum":["MEETING","ZOOM_WORKPLACE_BUNDLE"]},"license_option":{"type":"integer","description":"License option.\n\nFor the `MEETING` parameter, setting the corresponding value indicates that the user is converted to a licensed user. The specific values are as follows:\nUser's plan type. \n `2` - Licensed. \n\nFor the `ZOOM_WORKPLACE_BUNDLE` parameter, setting the corresponding value assigns the user a Zoom Workplace series license. The specific values are as follows:\nThe user's Zoom Workplace plan option. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited.\n\n The Zoom Workplace plan option for Govermnemt accounts. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus. \n\n The Zoom Workplace plan option for Education accounts. \n `18014398509481984` - Zoom Workplace for Education School and Campus. \n `72057594037927936` - Zoom Workplace for Education Enterprise Essentials. \n `576460752303423488` - Zoom Workplace for Education Enterprise Student. \n `144115188075855872` - Zoom Workplace for Education Enterprise Plus. \n `137438953472` - Zoom Workplace for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` - Zoom Workplace for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom Workplace for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom Workplace for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom Workplace for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom Workplace for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom Workplace for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom Workplace for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom Workplace for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom Workplace for Education Enterprise Premier with Global Select.","example":16,"enum":[2,4,8,16,32,64,128,33554432,134217728,1073741824,536870912,268435456,4398046511104,18014398509481984,72057594037927940,576460752303423500,144115188075855870,137438953472,1099511627776,549755813888,274877906944,2199023255552,4294967296,34359738368,17179869184,8589934592,68719476736]},"subscription_id":{"type":"string","description":"Subscription ID with the corresponding license.","example":"SUBREF-xxxxxx-xxxxxx"}}}}}}]}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `1120`
\n A valid invitation to join the Zoom account was not found for this user.
This error is thrown if you added a user in your account but the user did not accept the invitation on time and the invitation expired - thus making the userId invalid.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user_profile","user_info:read","user:read:user","user:read:user:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin","user_profile","user_info:read"],"x-granular-scopes":["user:read:user","user:read:user:admin"]}},"delete":{"tags":["Users"],"summary":"Delete a user","description":"**Disassociate** (unlink) a user or permanently **delete** a user. \n\n**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.\n\n\n**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.\n\n\nFor user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n**Note:** This API does not support the deletion requirements of a [Data Subject Access Request (DSAR)](https://dataprivacymanager.net/what-is-data-subject-access-request-dsar/). For a DSAR request, contact Zoom Support. \n\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:delete:user`,`user:delete:user:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userDelete","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"encrypted_email","in":"query","description":"Whether the email address passed for the `userId` value is an encrypted email address. \n\n * `true` - The email address is encrypted. \n * `false` - The email address is not encrypted. \n\n If you do not query this parameter, this value defaults to null (`false`).","required":false,"schema":{"type":"boolean","example":false,"default":false}},{"name":"action","in":"query","description":"Delete action options. \n `disassociate` - Disassociate a user. \n `delete`- Permanently delete a user. \n Note: To delete pending user in the account, use `disassociate`","required":false,"schema":{"type":"string","example":"delete","default":"disassociate","enum":["disassociate","delete"]}},{"name":"transfer_email","in":"query","description":"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. \nFor detailed behavior and requirements, refer to the `transfer_events` field description.","required":false,"schema":{"type":"string","example":"jchill@example.com"}},{"name":"transfer_meeting","in":"query","description":"Transfer meeting.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_webinar","in":"query","description":"Transfer webinar.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_recording","in":"query","description":"Transfer recording.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_whiteboard","in":"query","description":"When deleting a user, whether to transfer all their [Zoom Whiteboard](https://support.zoom.us/hc/en-us/articles/4410916881421) data to another user.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_clipfiles","in":"query","description":"Transfer clip files.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_notes","in":"query","description":"Transfer notes.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_visitors","in":"query","description":"Transfer visitors.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_docs","in":"query","description":"Transfer docs.","required":false,"schema":{"type":"boolean","example":false}},{"name":"transfer_events","in":"query","description":"Indicates whether to transfer Zoom Events.\n\nWhen `transfer_events` is set to `true`, the `transfer_email` field is required. Upon user deletion or disassociation, the user’s Zoom Events hub assets will be transferred to the specified target user.\nWhen `transfer_events` is set to `false`, the `transfer_email` field is not required, and no asset transfer will be performed.","required":false,"schema":{"type":"boolean","example":true,"default":true}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nUser deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n The transfer-to email address cannot be the same as the unlinked or deleted user's email address.
Unable to unlink API user(s).
This user has published events on Zoom Events and cannot be deleted or unlinked.
This user has published events on Zoom Events and you do not specify a target user to transfer data.
The destination user does not have a Zoom Events license and cannot receive this data.
The destination user does not have a $license or higher license and cannot receive this data.
\n**Error Code:** `200`
\n Cannot delete a user out of your account.
Cannot delete a Zoom Rooms user.
Unable to delete this deactivated user. Please contact Zoom support team for more information.
\n**Error Code:** `1000`
\n The user cannot be changed because they are a Call-queue manager or Auto-receptionist operator.
\n**Error Code:** `1107`
\n You can not disassociate a user with managed domain.
\n**Error Code:** `1117`
\n You can not disassociate an Admin user.
\n**Error Code:** `1120`
\n A valid invitation to join the Zoom account was not found for this user.
This error is thrown if you added a user in your account but the user did not accept the invitation on time and the invitation expired - thus making the userId invalid.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:delete:user","user:delete:user:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:delete:user","user:delete:user:admin"]}},"patch":{"tags":["Users"],"summary":"Update a user","description":"Updates a user's [Zoom profile](https://support.zoom.us/hc/en-us/articles/201363203-My-Profile) information. \n\n**Note**: \nIf display_name is empty, the API endpoint derives the display_name from the first_name and last_name values. \n\nFor user-level apps, pass [the `me` value](hhttps://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:update:user`,`user:update:user:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userUpdate","parameters":[{"name":"userId","in":"path","description":"The user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"login_type","in":"query","description":"The user's login method. \n* `0` - Facebook OAuth. \n* `1` - Google OAuth. \n* `24` - Apple OAuth. \n* `27` - Microsoft OAuth. \n* `97` - Mobile device. \n* `98` - RingCentral OAuth. \n* `99` - API user. \n* `100` - Zoom Work email. \n* `101` - Single Sign-On (SSO). \n\nThese login methods are only available in China. \n* `11` - Phone number. \n* `21` - WeChat. \n* `23` - Alipay.","required":false,"schema":{"type":"integer","example":101,"enum":[0,1,11,21,23,24,27,97,98,99,100,101]}},{"name":"remove_tsp_credentials","in":"query","description":"Whether to remove the user's TSP credentials. \n* `true` - The queried ID is an employee's unique ID. \n* `false` - The queried ID is not an employee's unique ID. \n\n This value defaults to `false` (null).","required":false,"schema":{"type":"boolean","example":true}}],"requestBody":{"description":"The user's profile information.","content":{"application/json":{"schema":{"title":"Update a user","type":"object","properties":{"cms_user_id":{"type":"string","description":"The Kaltura user ID.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"company":{"maxLength":255,"type":"string","description":"The user's company.","example":"Example, Inc."},"custom_attributes":{"maxItems":5,"type":"array","description":"The user's assigned custom attributes.","items":{"type":"object","properties":{"key":{"type":"string","description":"The custom attribute's key.","example":"cbf_cywdkexrtqc73f97gd4w6g"},"name":{"type":"string","description":"The custom attribute's name.","example":"A1"},"value":{"type":"string","description":"The custom attribute's value","example":"1"}}}},"dept":{"type":"string","description":"The user's assigned department.","example":"Developers"},"first_name":{"maxLength":64,"type":"string","description":"The user's first name. This value cannot contain more than five Chinese characters.","example":"Jill"},"group_id":{"type":"string","description":"This field provides the unique identifier of the group that you would like to add a [pending user](https://support.zoom.us/hc/en-us/articles/201363183-Managing-users#h_13c87a2a-ecd6-40ad-be61-a9935e660edb) to. Retrieve the value of this field from the [**List groups**](/docs/docs/api/rest/reference/user/methods/#operation/groups) API.","example":"RSMaSp8sTEGK0_oamiA2_w"},"division_ids":{"maxItems":1,"type":"array","description":"List of division IDs to be updated. Currently only a single division is supported.","items":{"type":"string","example":"xxxxxxxxxx"}},"host_key":{"maxLength":10,"minLength":6,"type":"string","description":"The user's host key.","example":"4692486817"},"job_title":{"maxLength":128,"type":"string","description":"The user's job title.","example":"Developer"},"cost_center":{"type":"string","description":"The user's cost center.","example":"cost center"},"language":{"type":"string","description":"The user's language.","example":"English"},"last_name":{"maxLength":64,"type":"string","description":"The user's last name. This value cannot contain more than five Chinese characters.","example":"Chill"},"location":{"maxLength":256,"type":"string","description":"The user's location.","example":"San Jose"},"manager":{"type":"string","description":"The user's assigned manager. To set a manager, provide the manager’s email address or display name within the same account.","format":"email","example":"Tara Smith"},"phone_country":{"type":"string","description":"**Note** This field has been **deprecated** and will not be supported in the future. Use the `country` field of the `phone_numbers` object to select the phone number country. \n\nThe user's phone number [country ID](https://marketplace.zoom.us/docs/api-reference/other-references/abbreviation-lists#countries).","example":"US","deprecated":true},"phone_number":{"type":"string","description":"**Note** This field has been **deprecated** and will not be supported in the future. Instead, use the `phone_numbers` field to assign phone numbers to a user. \n\nThe user's phone number. To update a phone number, you must also provide the `phone_country` field.","example":"5550100","deprecated":true},"phone_numbers":{"maxItems":3,"type":"array","description":"The information about the user's assigned phone numbers.","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's country code.","example":"+1"},"country":{"type":"string","description":"The phone number's [country ID](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries).","example":"US"},"label":{"type":"string","description":"The phone number's label. \n* `Mobile` \n* `Office` \n* `Home` \n* `Fax`","example":"Mobile","enum":["Mobile","Office","Home","Fax"]},"number":{"type":"string","description":"The phone number.","example":"5550100"}}}},"pmi":{"maxLength":10,"minLength":10,"type":"integer","description":"The user's [personal meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi).","example":1234567890},"pronouns":{"type":"string","description":"The user's pronouns.","example":"They/Them/Their"},"pronouns_option":{"type":"integer","description":"The user's display pronouns setting. \n* `1` - Ask the user every time they join meetings and webinars. \n* `2` - Always display pronouns in meetings and webinars. \n* `3` - Do not display pronouns in meetings and webinars.","example":1,"enum":[1,2,3]},"timezone":{"type":"string","description":"The user's [timezone](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#timezones)","example":"America/Chicago"},"type":{"type":"integer","description":"The type of [user](https://support.zoom.us/hc/en-us/articles/201363173-Zoom-user-types-roles).\n* `1` - Basic. \n* `2` - Licensed. \n* `4` - Unassigned without Meetings Basic. \n* `99` - None. You can only set this value if the user was created using the `ssoCreate` value for `action` parameter in the [**Create users**](/docs/api-reference/zoom-api/methods#operation/userCreate) API.\n\n**Note**: If a Zoom Workplace series plan is configured as the account’s base plan, you can directly assign the corresponding Zoom Workplace license by setting type = 2.","example":2,"enum":[1,2,4,99]},"use_pmi":{"type":"boolean","description":"Whether to use a [personal meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi) for instant meetings.","example":false,"default":false},"vanity_name":{"type":"string","description":"The user's personal meeting room name.","example":"My Meeting Room"},"display_name":{"maxLength":128,"type":"string","description":"The user's display name. This value cannot contain more than ten Chinese characters.","example":"Jill Chill"},"zoom_one_type":{"type":"integer","description":"The Zoom Workplace plan option. \n `0` - Turn off Zoom Workplace license. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited.\n \nThe Zoom One plan option for Gov accounts: \n `0` - Turn off Zoom One license. \n `16` - Zoom One Business Plus. \n \n The Zoom One plan option for Education accounts: \n `0` - Turn off Zoom One license. \n `18014398509481984` - Zoom One for Education School and Campus. \n `72057594037927936` - Zoom One for Education Enterprise Essentials. \n `576460752303423488` - Zoom One for Education Enterprise Student. \n `144115188075855872` - Zoom One for Education Enterprise Plus. \n `137438953472` - Zoom One for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` -Zoom One for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom One for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom One for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom One for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom One for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom One for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom One for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom One for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom One for Education Enterprise Premier with Global Select.","example":64,"enum":[0,16,32,64,128,33554432,134217728,268435456,536870912,1073741824,4398046511104,4294967296,8589934592,17179869184,34359738368,68719476736,137438953472,274877906944,549755813888,1099511627776,2199023255552,18014398509481984,72057594037927940,144115188075855870,576460752303423500]},"plan_united_type":{"type":"string","description":"The Zoom United type and license. \n* `1` - Zoom United Pro-United with US/CA Unlimited. \n* `2` - Zoom United Pro-United with UK/IR Unlimited. \n* `4` - Zoom United Pro-United with AU/NZ Unlimited. \n* `8` - Zoom United Pro-United with Global Select. \n* `16` - Zoom United Pro-United with Zoom Phone Pro. \n* `32` - Zoom United Biz-United with US/CA Unlimited. \n* `64` - Zoom United Biz-United with UK/IR Unlimited. \n* `128` - Zoom United Biz-United with AU/NZ Unlimited. \n* `256` - Zoom United Biz-United with Global Select. \n* `512` - Zoom United Biz-United with Zoom Phone Pro. \n* `1024` - Zoom United Ent-United with US/CA Unlimited. \n* `2048` - Zoom United Ent-United with UK/IR Unlimited. \n* `4096` - Zoom United Ent-United with AU/NZ Unlimited. \n* `8192` - Zoom United Ent-United with Global Select. \n* `16384` - Zoom United Ent-United with Zoom Phone Pro. \n* `32768` - Zoom United Pro-United with JP Unlimited. \n* `65536` - Zoom United Biz-United with JP Unlimited. \n* `131072` - Zoom United Ent-United with JP Unlimited. \n* `none` - Turn off Zoom United type.","example":"1","enum":["1","2","4","8","16","32","64","128","256","512","1024","2048","4096","8192","16384","32768","65536","131072","none"]},"feature":{"type":"object","properties":{"zoom_phone":{"type":"boolean","description":"Whether the user has the **Zoom Phone** feature enabled.","example":true}},"description":"The information about the user's features. If the value is set to false, will remove user from Zoom Phone. All numbers and phones assigned to the users will become unassigned. "},"about_me":{"maxLength":150,"type":"string","description":"The user's self-introduction. Hyperlinks or HTML code not allowed in this field.","example":"I'm a Zoom lover!"},"linkedin_url":{"type":"string","description":"The user's LinkedIn link. The URL must contain `linkedin.com`.","example":"https://www.linkedin.com/example"},"license_info_list":{"maxItems":2,"type":"array","description":"A list of license information used to specify the appropriate license type, license option, and license subscription reference ID. This list is only for accounts with multiple subscription plans enabled.","items":{"required":["license_option","license_type","subscription_id"],"type":"object","properties":{"license_type":{"type":"string","description":"License type name.\nThe `MEETING` license is associated with the paid user type, while the `ZOOM_WORKPLACE_BUNDLE` license corresponds to the Zoom Workplace series licenses.","example":"ZOOM_WORKPLACE_BUNDLE","enum":["MEETING","ZOOM_WORKPLACE_BUNDLE"]},"license_option":{"type":"integer","description":"License option.\n\nFor the `MEETING` parameter, setting the corresponding value indicates that the user is converted to a licensed user. The specific values are as follows:\nUser's plan type. \n `2` - Licensed. \n\nFor the `ZOOM_WORKPLACE_BUNDLE` parameter, setting the corresponding value assigns the user a Zoom Workplace series license. The specific values are as follows:\nThe user's Zoom Workplace plan option. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus with US/CA Unlimited. \n `32` - Zoom Workplace Business Plus with UK/IR Unlimited. \n `64` - Zoom Workplace Business Plus with AU/NZ Unlimited. \n `128` - Zoom Workplace Business Plus with Japan Unlimited. \n `33554432` - Zoom Workplace Business Plus with Global Select. \n `134217728` - Zoom Workplace Enterprise Premier with US/CA Unlimited. \n `1073741824` - Zoom Workplace Enterprise Premier with AU/NZ Unlimited. \n `536870912` - Zoom Workplace Enterprise Premier with UK/IR Unlimited. \n `268435456` - Zoom Workplace Enterprise Premier with Japan Unlimited. \n `4398046511104` - Zoom Workplace Pro Plus with US/CA Unlimited.\n\n The Zoom Workplace plan option for Govermnemt accounts. \n `4` - Zoom Workplace Enterprise. \n `8` - Zoom Workplace Enterprise Plus. \n `16` - Zoom Workplace Business Plus. \n\n The Zoom Workplace plan option for Education accounts. \n `18014398509481984` - Zoom Workplace for Education School and Campus. \n `72057594037927936` - Zoom Workplace for Education Enterprise Essentials. \n `576460752303423488` - Zoom Workplace for Education Enterprise Student. \n `144115188075855872` - Zoom Workplace for Education Enterprise Plus. \n `137438953472` - Zoom Workplace for Education School and Campus Plus with US/CA Unlimited. \n `1099511627776` - Zoom Workplace for Education School and Campus Plus with AU/NZ Unlimited. \n `549755813888` - Zoom Workplace for Education School and Campus Plus with UK/IR Unlimited. \n `274877906944` - Zoom Workplace for Education School and Campus Plus with Japan Unlimited. \n `2199023255552` - Zoom Workplace for Education School and Campus Plus with Global Select. \n `4294967296` - Zoom Workplace for Education Enterprise Premier with US/CA Unlimited. \n `34359738368` - Zoom Workplace for Education Enterprise Premier with AU/NZ Unlimited. \n `17179869184` -Zoom Workplace for Education Enterprise Premier with UK/IR Unlimited. \n `8589934592` - Zoom Workplace for Education Enterprise Premier with with Japan Unlimited. \n `68719476736` - Zoom Workplace for Education Enterprise Premier with Global Select.\n","example":16,"enum":[2,4,8,16,32,64,128,33554432,134217728,1073741824,536870912,268435456,4398046511104,18014398509481984,72057594037927940,576460752303423500,144115188075855870,137438953472,1099511627776,549755813888,274877906944,2199023255552,4294967296,34359738368,17179869184,8589934592,68719476736]},"subscription_id":{"type":"string","description":"The subscription ID associated with the corresponding license.","example":"SUBREF-xxxxxx-xxxxxx"}}}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nUser updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n * A Zoom Room user cannot be changed to a free user type: $userId \n* A Zoom Room user cannot be changed to a no-meeting-license user type: $userId. \n* You cannot change PMI information for a \"No Meetings License\" user. \n* Only an account administrator can change a user's name. \n* Only an account administrator can change the host key. \n* Only an account administrator can change a Personal Meeting ID (PMI). \n* Only an account administrator can change a vanity name.
\n**Error Code:** `300`
\n * Your request could not be completed because the name contains an invalid word: {name} \n* You cannot change the user type to \"Basic\" because this user has an upcoming Zoom Events scheduled. \n* Invalid parameter: password \n* The value provided for \"plan_united_type\" parameter is invalid. Try again with a valid value. \n* You can't change the \"type\" or \"plan_united_type\" or \"zoom_one_type\" at the same time. \n* You can't turn off your Zoom One license now because you are having Zoom One as your basic plan type. \n* The `about_me` field is illegal and can't contain hyperlinks or HTML code. \n* The `linkedin_url` field is illegal. The URL must contain `linkedin.com`. \n* Your account can't set user type as On-prem.\n* The subscription \"{subscriptionId}\" you entered does not exist. Please choose a different subscription and try again.
\n**Error Code:** `1108`
\n Permission requirements to change the user type of this user were not met.
\n**Error Code:** `1109`
\n Host is not a paid user.
\n**Error Code:** `1120`
\n A valid invitation to join the Zoom account wasn't found for this user. This error happens if you add a user to your account but the user didn't accept the invitation and the invitation expired, making the `userId` invalid.
\n**Error Code:** `2034`
\n Your request to convert this user's plan type to \"{0}\" wasn't approved because your account has reached the permitted maximum number of \"{1}\" users. Purchase additional licenses or contact the Zoom support team to provision additional users in your account.
\n**Error Code:** `2033`
\n Your request to convert the user type to \"Basic\" was not approved because you have already reached the maximum basic user limit allowed in your account. For additional help regarding this issue, contact the Zoom Customer Support team.
\n**Error Code:** `3412`
\n * Your request to convert the user type of this \"{$userType}\" user to a \"Basic\" user was not approved at this time because your account has reached the permitted maximum number of \"{$maxAllowedNumber}\" Basic users. Remove existing basic user(s) from your \"Users\" list or the \"Pending Users\" list before attempting to convert a user to a Basic user. \n* Your request to convert the user type of a \"Basic\" user to a \"{$userType}\" user was not approved at this time because your account has reached the permitted maximum number of \"{$maxAllowedNumber}\" paying users. Please purchase additional licenses or remove existing paying user(s) from your \"Users\" list or the \"Pending Users\" list before attempting to convert a user to a paying user. \n* Your request to convert the user type of a \"{$userType}\" user to a \"No-Meeting License\" user was not approved at this time because your account has reached the permitted maximum number of \"{$maxAllowedNumber}\" No-Meeting License users. Remove the existing No-Meeting License user(s) from your \"Users\" list or the \"Pending Users\" list before attempting to convert a user to a No-Meeting License user.\n* Your request to convert the user type of this basic user to a \"{$userType}\" user was not approved at this time because the subscription \"{$subscriptionId}\" has reached the permitted maximum number of \"{$maxAllowedNumber}\" paying users. Please choose a different subscription and try again.
\n**Error Code:** `4100`
\n User is already taken by another user from your account. Choose another \"Personal Link Name\".
\n**Error Code:** `2038`
\n * Your request to convert the plan type of this user was not approved at this time because your account has reached the permitted maximum number. Please purchase additional licenses or contact the Zoom support team to provision additional users in your account.\n* Your request to convert the plan type of this user was not approved at this time because the subscription \"{subscriptionId}\" doesn’t have enough licenses available to assign. Please choose a different subscription and try again.
\n**Error Code:** `2039`
\n * You can't turn off your Zoom United license now because you don't have enough basic licenses. \n* You can't turn off your Zoom One license now because you don't have enough basic licenses. \n* No permission
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:update:user","user:update:user:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:update:user","user:update:user:admin"]}}},"/users/{userId}/assistants":{"get":{"tags":["Users"],"summary":"List user assistants","description":"List a user's assistants. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nAssistants are users who the current user has assigned [scheduling privilege](https://support.zoom.us/hc/en-us/articles/201362803-Scheduling-Privilege). These assistants can schedule meetings on behalf of the current user, as well as manage and act as an alternative host for all meetings if the admin has enabled the [co-host option](https://zoom.us/account/setting) on the account.\n\n**Prerequisites:** \n* Current user as well as the assistant must have Licensed or an On-prem license.\n* Assistants must be under the current user's account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`,`user_profile`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:list_assistants`,`user:read:list_assistants:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"userAssistants","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nSuccess.","content":{"application/json":{"schema":{"title":"User assistants list.","type":"object","properties":{"assistants":{"maximum":30,"type":"array","description":"List of the user's assistants.","items":{"type":"object","properties":{"email":{"type":"string","description":"Assistant's email address.","example":"jchill@example.com"},"id":{"type":"string","description":"Assistant's user ID.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"can_manage_host_private_event":{"type":"boolean","description":"The assistant can manage my private events.","example":true}}}}},"description":"List of user's assistants."}}}},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user_profile","user:read:list_assistants","user:read:list_assistants:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin","user_profile"],"x-granular-scopes":["user:read:list_assistants","user:read:list_assistants:admin"]}},"post":{"tags":["Users"],"summary":"Add assistants","description":"Assign assistants to a user. \n\nIn the request body, provide either the user's ID or the user's email address. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nAssistants are the users to whom the current user has assigned [scheduling privileges](https://support.zoom.us/hc/en-us/articles/201362803-Scheduling-Privilege). Assistants can schedule meetings on behalf of the current user, and can also manage and act as an alternative host for all meetings if the admin has enabled the [co-host option](https://zoom.us/account/setting) on the account.\n\n**Prerequisites:** \n* The user as well as the assistant must have Licensed or an On-prem license.\n* Assistants must be under the current user's account, or the assistants' account must be in the same organization as the current user's account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:assistant`,`user:write:assistant:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"userAssistantCreate","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"User assistant.","content":{"application/json":{"schema":{"title":"User assistants list","type":"object","properties":{"assistants":{"maximum":30,"maxItems":30,"type":"array","description":"List of user's assistants.","items":{"type":"object","properties":{"email":{"type":"string","description":"Assistant's email address.","example":"jchill@example.com"},"id":{"type":"string","description":"Assistant's user ID.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"can_manage_host_private_event":{"type":"boolean","description":"The assistant can manage my private events.","example":true}}}}},"description":"List of user's assistants."}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n \nAssistant added.","content":{"application/json":{"schema":{"type":"object","properties":{"add_at":{"type":"string","format":"date-time","example":"2018-10-31T04:32:37Z"},"ids":{"type":"string","description":"User ID.","example":"KDcuGIm1QgePTO8WbOqwIQ"}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Current account must be paid account: $userId
\nThe user must either be a Licensed user or an On-prem user : $userId.
\nCan't assign scheduling privilege to yourself.
\nCan't find user $email.
\nUser $email has already granted scheduling privilege.
\nThe user must either be a Licensed user or an On-prem user : $email.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:write:assistant","user:write:assistant:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:write:assistant","user:write:assistant:admin"]}},"delete":{"tags":["Users"],"summary":"Delete user assistants","description":"Delete all of the current user's assistants. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nAssistants are the users who the current user has assigned [scheduling privilege](https://support.zoom.us/hc/en-us/articles/201362803-Scheduling-Privilege). These assistants can schedule meeting on behalf of the current user, and manage and act as an alternative host for all meetings if the admin has enabled [co-host option](https://zoom.us/account/setting) on the account.\n\n**Prerequisites:** \n* The user as well as the assistant must have Licensed or an On-prem license.\n* Assistants must be under the current user's account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:delete:assistant`,`user:delete:assistant:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userAssistantsDelete","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content** \n \nAssistants deleted."},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:delete:assistant","user:delete:assistant:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:delete:assistant","user:delete:assistant:admin"]}}},"/users/{userId}/assistants/{assistantId}":{"delete":{"tags":["Users"],"summary":"Delete a user assistant","description":"Delete a specific assistant of a user. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nAssistants are the users who the current user has assigned [scheduling privilege](https://support.zoom.us/hc/en-us/articles/201362803-Scheduling-Privilege). These assistants can schedule meeting on behalf of the current user as well as manage and act as an alternative host for all meetings if the admin has enabled [co-host option](https://zoom.us/account/setting) on the account.\n\n**Prerequisites:** \n* The user as well as the assistant must have Licensed or an On-prem license.\n* Assistants must be under the current user's account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:delete:assistant`,`user:delete:assistant:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userAssistantDelete","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"assistantId","in":"path","description":"Assistant ID.","required":true,"schema":{"type":"string","example":"KDcuGIm1QgePTO8WbOqwIQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK** \n \nAssistant deleted."},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:delete:assistant","user:delete:assistant:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:delete:assistant","user:delete:assistant:admin"]}}},"/users/{userId}/collaboration_devices":{"get":{"tags":["Users"],"summary":"List a user's collaboration devices","description":"List a user's collaboration devices. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:list_collaboration_devices`,`user:read:list_collaboration_devices:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"listCollaborationDevices","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \n Collaboration device list returned.","content":{"application/json":{"schema":{"type":"object","properties":{"total_records":{"type":"integer","description":"Total number of records returned.","example":30},"collaboration_devices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The device's unique identifier.","example":"F1C6E9DF-429E-4FA1-85DA-AC95464F3D18"},"device_name":{"type":"string","description":"Name of the Personal Zoom Room's device.","example":"Test Computer"},"room_name":{"type":"string","description":"Name of the Personal Zoom Room.","example":"My Personal Zoom Room"},"room_user_id":{"type":"string","description":"The device's unique identifier.","example":"HgCQF82ZS5GiQ4x_fCx0MB"},"status":{"type":"string","description":"The device's status. The value can be either `Online` or `Offline`.","example":"Online","enum":["Online","Offline"]}},"description":"Information about the collaboration device detail."}}}}}}},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId .
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user:read:list_collaboration_devices","user:read:list_collaboration_devices:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["MobileDeviceManagement:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin"],"x-granular-scopes":["user:read:list_collaboration_devices","user:read:list_collaboration_devices:admin"]}}},"/users/{userId}/collaboration_devices/{collaborationDeviceId}":{"get":{"tags":["Users"],"summary":"Get collaboration device detail","description":"Get collaboration device detail. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:collaboration_device`,`user:read:collaboration_device:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getCollaborationDevice","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"collaborationDeviceId","in":"path","description":"The collaboration device ID.","required":true,"schema":{"type":"string","example":"de2cb730-50c3-4f1e-8ba5-58136dea3675"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \n Collaboration device returned.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The device's unique identifier.","example":"F1C6E9DF-429E-4FA1-85DA-AC95464F3D18"},"device_name":{"type":"string","description":"Name of the Personal Zoom Room's device.","example":"Test Computer"},"room_name":{"type":"string","description":"Name of the Personal Zoom Room.","example":"My Personal Zoom Room"},"room_user_id":{"type":"string","description":"The Zoom Room's unique identifier.","example":"HgCQF82ZS5GiQ4x_fCx0MB"},"status":{"type":"string","description":"The device's status. The value can be either `Online` or `Offline`.","example":"Online","enum":["Online","Offline"]}},"description":"Information about the collaboration device detail."}}}},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId
\n**Error Code:** `1238`
\n Collaboration Device does not exist: {0}.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user:read:collaboration_device","user:read:collaboration_device:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["MobileDeviceManagement:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin"],"x-granular-scopes":["user:read:collaboration_device","user:read:collaboration_device:admin"]}}},"/users/{userId}/email":{"put":{"tags":["Users"],"summary":"Update a user's email","description":"Change a user's [email address](https://support.zoom.us/hc/en-us/articles/201362563-How-Do-I-Change-the-Email-on-My-Account-) on a Zoom account that has managed domain set up. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n* If the Zoom account in which the user belongs has multiple [managed domains](https://support.zoom.us/hc/en-us/articles/203395207-What-is-Managed-Domain-), then the email to be updated **must** match one of the managed domains.\n* A user's email address can be changed up to 3 times in any 24 hour period.\n\n**Prerequisites:** \n* Managed domain must be enabled in the account. \n* The new email address should not already exist in Zoom.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:update:email`,`user:update:email:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userEmailUpdate","parameters":[{"name":"userId","in":"path","description":"The users's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"User email.","content":{"application/json":{"schema":{"required":["email"],"type":"object","properties":{"email":{"type":"string","description":"User's email. The length should be less than 128 characters.","format":"email","example":"jchill@example.com"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content** \n \nEmail updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only an account administrator can change email.
\n**Error Code:** `1000`
\n Admin can not change other admins email.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $email.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:update:email","user:update:email:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:update:email","user:update:email:admin"]}}},"/users/{userId}/meeting_summary_templates":{"get":{"tags":["Users"],"summary":"Get meeting summary templates","description":"Get a list of meeting summary templates. \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:settings`,`user:read:settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"Getmeetingsummarytemplates","parameters":[{"name":"userId","in":"path","description":"current user's id","required":true,"schema":{"type":"string","example":"User Id"}}],"responses":{"200":{"description":"return meeting summary template list","content":{"application/json":{"schema":{"type":"array","items":{"title":"root","required":["description","meeting_summary_template_id","name"],"type":"object","properties":{"meeting_summary_template_id":{"type":"string","description":"summary template id","example":"1e1356ad"},"name":{"type":"string","description":"summary template name","example":"General template"},"description":{"type":"string","description":"summary template description","example":"Recap and next steps"}}}}}}}},"security":[{"openapi_oauth":["user:read","user:read:admin","user:read:settings","user:read:settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:read:admin"],"x-granular-scopes":["user:read:settings","user:read:settings:admin"]}}},"/users/{userId}/meeting_templates/{meetingTemplateId}":{"get":{"tags":["Users"],"summary":"Get meeting template detail","description":"Retrieve a user's [meeting template](https://support.zoom.us/hc/en-us/articles/360036559151-Meeting-templates). For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:admin`,`user:read`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`","operationId":"getUserMeetingTemplates","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"meetingTemplateId","in":"path","description":"The meeting template ID.","required":true,"schema":{"type":"string","example":"ydCUQzzVT6WZ_r_K_2iFzg"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n Meeting Template returned.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Meeting template ID.","example":"Q4COb7QVRVmO0896Ry4XHg"},"name":{"type":"string","description":"Meeting template name.","example":"Meeting template name"},"settings":{"type":"object","properties":{"in_meeting":{"type":"object","properties":{"entry_exit_chime":{"type":"string","description":"Play sound when participants join or leave. \n `host` - Heard by host only. \n `all` - Heard by host and all attendees. \n `none` - Disable.","example":"none","enum":["host","all","none"],"x-enum-descriptions":["Heard by host only","Heard by host and all attendees","Disable"]},"feedback":{"type":"boolean","description":"Add a **Feedback** tab to the Windows Settings or Mac Preferences dialog. Enable users to provide feedback to Zoom at the end of the meeting.","example":true},"polling":{"type":"boolean","description":"Add 'Polls' to the meeting controls. This allows the host to survey the attendees.","example":true},"post_meeting_feedback":{"type":"boolean","description":"Whether to display a thumbs up or thumbs down feedback survey at the end of each meeting.","example":true},"screen_sharing":{"type":"boolean","description":"Whether to allow hosts and participants to share their screen or content during meetings.","example":true},"who_can_share_screen":{"type":"string","description":"The type of user who can share their screen or content during meetings. \n* `host` - Only hosts can screen share. \n* `all` - Both hosts and participants can screen share.","example":"all","enum":["host","all"]},"who_can_share_screen_when_someone_is_sharing":{"type":"string","description":"Indicates who is allowed to start sharing screen when someone else in the meeting is sharing their screen. The value can be one of the following: \n \n`host`: Only a host can share the screen when someone else is sharing. \n \n`all`: Anyone in the meeting is allowed to start sharing their screen when someone else is sharing. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"all","enum":["host","all"]},"disable_screen_sharing_for_host_meetings":{"type":"boolean","description":"Whether the **Disable desktop screen sharing for meetings you host** setting is enabled.","example":true},"annotation":{"type":"boolean","description":"Allow participants to use annotation tools to add information to shared screens.","example":true},"whiteboard":{"type":"boolean","description":"Allow participants to share a whiteboard that includes annotation tools.","example":true},"remote_control":{"type":"boolean","description":"Whether to enable the [**Remote control**](https://support.zoom.us/hc/en-us/articles/201362673-Requesting-or-giving-remote-control) setting.","example":true},"non_verbal_feedback":{"type":"boolean","description":"Allow participants in a meeting to provide nonverbal feedback and express opinions by clicking on icons in the Participants panel.","example":true},"allow_participants_to_rename":{"type":"boolean","description":"If the value of this field is set to `true`, meeting participants and webinar panelists are allowed to rename themselves during a meeting or a webinar.\n","example":true},"breakout_room":{"type":"boolean","description":"Allow the meeting host to split meeting participants into separate breakout rooms.","example":true},"remote_support":{"type":"boolean","description":"Allow meeting host to provide 1:1 remote support to another participant.","example":true},"manual_captioning":{"type":"object","properties":{"auto_generated_captions":{"type":"boolean","description":"Whether to enable Zoom's [live transcription feature](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription#h_01FHGGHYJ4457H4GSZY0KM3NSB).","example":true},"allow_to_type":{"type":"boolean","description":"Whether the host can manually caption or let the host assign a participant to provide manual captioning.","example":true},"manual_captions":{"type":"boolean","description":"Whether to [enable manual closed captioning](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription).","example":true},"save_captions":{"type":"boolean","description":"Allow participants to save closed captions.","example":true}},"description":"Information about manual captioning settings."},"closed_captioning":{"type":"object","properties":{"auto_transcribing":{"type":"boolean","description":"Whether to allow live transcription service to transcribe meeting automatically.","example":true},"enable":{"type":"boolean","description":"Whether to allow the host to type closed captions or assign a participant or 3rd-party service to provide closed captioning.","example":true},"save_caption":{"type":"boolean","description":"Whether to allow participants to save closed captions or transcripts.","example":true}},"description":"Information about closed captioning settings."}}},"recording":{"type":"object","properties":{"auto_recording":{"type":"string","description":"Automatic recording: \n `local` - Record on local. \n `cloud` - Record on cloud. \n `none` - Disabled.","example":"cloud","enum":["local","cloud","none"],"x-enum-descriptions":["Record on local","Record on cloud","Disabled"]}}},"schedule_meeting":{"type":"object","properties":{"host_video":{"type":"boolean","description":"Start meetings with host video on.","example":true},"participant_video":{"type":"boolean","description":"Start meetings with the participant video on. Participants can change this setting during the meeting.","example":true},"mute_upon_entry":{"type":"boolean","description":"Mute participants upon entry.","example":false,"default":false}}},"meeting_security":{"type":"object","properties":{"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting. \n\n When the **Waiting Room** feature is enabled, the [**Allow participants to join before host**](https://support.zoom.us/hc/en-us/articles/202828525-Allow-participants-to-join-before-host) setting is disabled.","example":true}}}},"description":"Meeting Template settings."}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read:admin","user:read"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["user:read:admin","user:read"]}}},"/users/{userId}/password":{"put":{"tags":["Users"],"summary":"Update a user's password","description":"Update the [password](https://support.zoom.us/hc/en-us/articles/206344385-Change-a-User-s-Password) of a user using which the user can login to Zoom. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nAfter this request is processed successfully, an email notification is sent to the user saying that the password was changed. \n \n**Prerequisites:** \n \n* Owner or admin of the Zoom account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:update:password`,`user:update:password:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`","operationId":"userPassword","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"User password.","content":{"application/json":{"schema":{"required":["password"],"type":"object","properties":{"password":{"minimum":8,"type":"string","description":"User password. Should be fewer than 32 characters.\n\n**Note** If the account owner or admin has enabled [enhanced password requirements](https://support.zoom.us/hc/en-us/articles/360034675592-Advanced-security-settings#h_fa9186e4-6818-4f7a-915c-2e25c19f0acd), the value provided in this field must meet those requirements. Retrieve these requirements by calling the [**Get account settings](/api-reference/zoom-api/ma#operation/accountSettings) API and referring to the `password_requirement` field present in the `security` object.","example":"if42!LfH@"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK** \n \nPassword updated."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n Your new password can not match the old password.
This password cannot be changed because it has already been changed the maximum number of times over the past 24 hours.
\n**Error Code:** `1117`
\n Can not update Admin's password
\n**Error Code:** `1123`
\n Can only update password of Zoom work email account
\n**Error Code:** `1124`
\n Minimum of 6 characters.
Have at least {lengthRule} characters
\n**Error Code:** `1125`
\n Have at least 1 letter (a, b, c…)
\n**Error Code:** `1126`
\n Have at least 1 number (1, 2, 3…)
\n**Error Code:** `1127`
\n Have at least 1 special character (!, @, #…)
\n**Error Code:** `1128`
\n Include both Upper case and Lower case characters
\n**Error Code:** `1129`
\n Users cannot reuse any of the last $formerPwdCount passwords created.
\n**Error Code:** `1130`
\n Password can't use the same character.
\n**Error Code:** `1131`
\n Password can't use continuation character.Such as 'abcdef','123456'.
\n**Error Code:** `1136`
\n Your password is too easy to guess. Try another one.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:update:password","user:update:password:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:update:password","user:update:password:admin"]}}},"/users/{userId}/permissions":{"get":{"tags":["Users"],"summary":"Get user permissions","description":"Get permissions that have been granted to the user. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nUsers can be assigned a set of permissions that allows them to access only the pages or information that a user needs to view or edit.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`,`user_profile`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:list_permissions`,`user:read:list_permissions:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userPermission","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nUser permissions returned.","content":{"application/json":{"schema":{"type":"object","properties":{"permissions":{"type":"array","description":"[List of user permissions.](https://developers.zoom.us/docs/api/rest/other-references/privileges/)","items":{"type":"string","example":"Branding:Edit"}}}}}}},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user_profile","user:read:list_permissions","user:read:list_permissions:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin","user_profile"],"x-granular-scopes":["user:read:list_permissions","user:read:list_permissions:admin"]}}},"/users/{userId}/picture":{"post":{"tags":["Users"],"summary":"Upload a user's profile picture","description":"Upload a user's profile picture. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nProvide `multipart/form-data` as the value of the `content-type` header for this request. This API supports `.jpeg` and `.png` file formats.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:profile_picture`,`user:write:profile_picture:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`","operationId":"userPicture","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["pic_file"],"type":"object","properties":{"pic_file":{"type":"string","description":"The file's path.","example":"profile.png"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` \n Picture uploaded.","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n Your request was not accepted because the profile picture contains invalid or explicit content.
\n**Error Code:** `200`
\n Only an account administrator can change a profile picture.
\n**Error Code:** `120`
\n File is empty.
\nFile size cannot exceed 2M.
\nOnly jpg/jpeg or png image file can be uploaded.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:write:profile_picture","user:write:profile_picture:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:write:profile_picture","user:write:profile_picture:admin"]}},"delete":{"tags":["Users"],"summary":"Delete a user's profile picture","description":"Delete a user's profile picture. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter. \n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`","operationId":"userPictureDelete","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nNo Content \n \nUser picture deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Only an account administrator can change a profile picture.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["user:write:admin","user:write"]}}},"/users/{userId}/presence_status":{"get":{"tags":["Users"],"summary":"Get a user presence status","description":"Returns a user's current status.\n\nUsers in the Zoom desktop client and mobile apps are assigned with a [presence status](https://support.zoom.us/hc/en-us/articles/360032554051-Status-Icons). The presence status displays the user's availability. \n\nThe available statuses are:\n* **Away**\n* **Do not disturb**\n* **Available**\n* **In a calendar event**\n* **Presenting**\n* **In a Zoom meeting**\n* **On a call**\n* **Out of Office**\n* **Busy**\n* **Offline**\n\nIf the presence status is **Do not disturb**, `end_time` and `remaining_time` properties are only visible if the user being queried is also the current user.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:presence_status`,`user:read:presence_status:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getUserPresenceStatus","parameters":[{"name":"userId","in":"path","description":"The user ID, email address, or member ID. The user can be either a company user or an external user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK** User Presence Status object returned.","content":{"application/json":{"schema":{"description":"The presence status object.","oneOf":[{"title":"self_dnd_case","required":["end_time","remaining_time","status"],"type":"object","properties":{"status":{"type":"string","description":"The user's presence status in the Zoom Chat client. The status has to be `Do_Not_Disturb`.","example":"Do_Not_Disturb","enum":["Do_No_Disturb"]},"end_time":{"type":"string","description":"The Do_Not_Disturb end date and time (UTC Time Zone).","example":"2024-03-27T04:00:00Z"},"remaining_time":{"type":"number","description":"The remaining time for `Do_Not_Disturb` status to end in seconds.","example":60}},"description":"For the case that the user queries for self and presence status is `Do_Not_Disturb`"},{"title":"other_cases","required":["status"],"type":"object","properties":{"status":{"type":"string","description":"The user's presence status in the Zoom Chat client. The status can be one of the following: `Away` `Available` `Offline` `In_A_Meeting` `In_A_Call` `In_A_Calendar_Event` `Presenting` `Out_of_Office` `Busy` `Do_Not_Disturb`","example":"Available","enum":["Away","Do_Not_Disturb","Available","In_Calendar_Event","Presenting","In_A_Zoom_Meeting","On_A_Call","Out_of_Office","Busy"]}},"description":"For the following cases: 1) if the user queries for self and the presence status is not `Do_Not_Disturb`; or 2) if user queries for other users."}]}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `5301`
\n Request to read the presence status of this user failed.
\n**Error Code:** `5411`
\n Unauthorized request. You do not have permission to get the presence status of this user.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: {userId}
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:read:admin","user:read:presence_status","user:read:presence_status:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:read:admin"],"x-granular-scopes":["user:read:presence_status","user:read:presence_status:admin"]}},"put":{"tags":["Users"],"summary":"Update a user's presence status","description":"Update a user's presence status. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nA user's status **cannot** be updated more than once per minute. For example, you can only submit a maximum of one update request per minute for a single user.\n\nUsers in the Zoom desktop client and mobile apps are assigned with a [presence status](https://support.zoom.us/hc/en-us/articles/360032554051-Status-Icons). The presence status informs users of their contact's availability. Users can also change their own presence status to one the following:\n* **Away**\n* **Do not disturb**\n* **Available**\n* **In a calendar event**\n* **Presenting**\n* **In a Zoom meeting**\n* **On a call**\n* **Out of Office**\n* **Busy**\n\nNote that a user's presence status **cannot** be updated via this API if the user is not logged in to the Zoom client.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:update:presence_status`,`user:update:presence_status:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updatePresenceStatus","parameters":[{"name":"userId","in":"path","description":"The user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string","example":"example@example.com"}}],"requestBody":{"content":{"application/json":{"schema":{"description":"There are two cases: for all statuses except `Do_No_Disturb`; and for `Do_No_Disturb` status.","oneOf":[{"title":"For all statuses except `Do_No_Disturb`","required":["status"],"type":"object","properties":{"status":{"type":"string","description":"The user's presence status. \n* `Away`\n* `Available` \n* `In_Calendar_Event` \n* `Presenting` \n* `In_A_Zoom_Meeting` \n* `On_A_Call` \n* `Out_of_Office`\n* `Busy`\n\nUsers who are on Zoom Client with a version **lower than 5.3.0** can update the status from: \n* `Away` to `Do_Not_Disturb` \n* `Available` to `Do_Not_Disturb` \n\nUsers who are on **Zoom Client 5.3.0 or higher** can update the status from: \n* `Do_Not_Disturb` to `Away`\n* `Do_Not_Disturb` to `Available` \n* `Available` to `Away` \n* `Away` to `Available`","example":"Available","enum":["Away","Available","In_Calendar_Event","Presenting","In_A_Zoom_Meeting","On_A_Call","Out_of_Office","Busy"]}},"description":"For setting presence statuses except `Do_No_Disturb`."},{"title":"For `Do_No_Disturb` status with duration","required":["status"],"type":"object","properties":{"status":{"type":"string","description":"The user's presence status. \n* `Do_Not_Disturb` \n\nUsers who are on Zoom client with a version **lower than 5.3.0** can update the status from: \n* `Away` to `Do_Not_Disturb` \n* `Available` to `Do_Not_Disturb` \n\nUsers who are on **Zoom client 5.3.0 or higher** can update the status from: \n* `Do_Not_Disturb` to `Away`\n* `Do_Not_Disturb` to `Available` \n* `Available` to `Away` \n* `Away` to `Available`","example":"Do_No_Disturb","enum":["Do_No_Disturb"]},"duration":{"maximum":1440,"minimum":1,"type":"integer","description":"If updating the user's status to `Do_Not_Disturb`, the duration that the status should remain as `Do_Not_Disturb`, in minutes. Duration value must be between 1 and 1440 minutes (24 hours). If duration is not set, the default value is 20 minutes.","example":20}},"description":"For `Do_No_Disturb` status setting with duration"}]}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nStatus updated successfully."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `5301`
\n Request to update the presence status of this user failed.
\n**Error Code:** `5411`
\n Unauthorized request. You do not have permission to update the presence status of this user.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: {userId}
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write","user:write:admin","user:update:presence_status","user:update:presence_status:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write","user:write:admin"],"x-granular-scopes":["user:update:presence_status","user:update:presence_status:admin"]}}},"/users/{userId}/schedulers":{"get":{"tags":["Users"],"summary":"List user schedulers","description":"List all of a user's schedulers. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nSchedulers in this context are users who can schedule meetings for the current user. For example, if the current user, the user whose `userId` was passed in the `path` parameter, is **User A**, this API's response will list all users for whom **User A** can schedule and manage meetings. **User A** is the assistant of these users, and thus has scheduling privilege for these users.\n\n**Prerequisites** \n* Current user must be under the same account as the scheduler.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`,`user_profile`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:list_schedulers`,`user:read:list_schedulers:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`","operationId":"userSchedulers","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n Successfully listed all schedulers of the user.","content":{"application/json":{"schema":{"title":"User schedulers List","type":"object","properties":{"schedulers":{"maximum":30,"type":"array","description":"List of users for whom the current user can schedule meetings.","items":{"type":"object","properties":{"email":{"type":"string","description":"Email address of the scheduler.","example":"jchill@example.com"},"id":{"type":"string","description":"Unique Identifier (User ID) of the Scheduler.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"pmi":{"type":"integer","description":"PMI of the meeting host in long (int64) format.","format":"int64","example":3542471135}}}}},"description":"List of user's schedulers."}}}},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user_profile","user:read:list_schedulers","user:read:list_schedulers:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin","user_profile"],"x-granular-scopes":["user:read:list_schedulers","user:read:list_schedulers:admin"]}},"delete":{"tags":["Users"],"summary":"Delete user schedulers","description":"Delete all of a user's schedulers. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nSchedulers are users on whose behalf the current user (assistant) can schedule meetings for. By calling this API, the current user will no longer be a scheduling assistant of any user. \n\n**Prerequisites:** \n* Current user (assistant) must be under the same account as the scheduler.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:delete:scheduler`,`user:delete:scheduler:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userSchedulersDelete","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n All schedulers deleted.\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:delete:scheduler","user:delete:scheduler:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:delete:scheduler","user:delete:scheduler:admin"]}}},"/users/{userId}/schedulers/{schedulerId}":{"delete":{"tags":["Users"],"summary":"Delete a scheduler","description":"Delete a scheduler. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nSchedulers are users who the current user (assistant) can schedule meetings on their behalf. By calling this API, the current user will no longer be a scheduling assistant of this scheduler.\n\n**Prerequisites:** \n* Current user must be under the same account as the scheduler.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:delete:scheduler`,`user:delete:scheduler:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Light`","operationId":"userSchedulerDelete","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"schedulerId","in":"path","description":"Scheduler's ID.","required":true,"schema":{"type":"string","example":"KDcuGIm1QgePTO8WbOqwIQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nScheduler deleted."},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:delete:scheduler","user:delete:scheduler:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:delete:scheduler","user:delete:scheduler:admin"]}}},"/users/{userId}/settings":{"get":{"tags":["Users"],"summary":"Get user settings","description":"Retrieve a user's settings. \nFor user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:settings`,`user:read:settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"userSettings","parameters":[{"name":"userId","in":"path","description":"The user ID or email address of the user. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"login_type","in":"query","description":"The user's login method. \n* `0` - Facebook OAuth \n* `1` - Google OAuth \n* `24` - Apple OAuth \n* `27` - Microsoft OAuth \n* `97` - Mobile device \n* `98` - RingCentral OAuth \n* `99` - API user \n* `100` - Zoom Work email \n* `101` - Single Sign-On (SSO) \n\nThese login methods are only available in China: \n* `11` - Phone number \n* `21` - WeChat \n* `23` - Alipay","required":false,"schema":{"type":"integer","example":101,"enum":[0,1,11,21,23,24,27,97,98,99,100,101]}},{"name":"option","in":"query","description":"Optional query parameters. \n* `meeting_authentication` - Use this query parameter to view the [meeting authentication settings](https://support.zoom.us/hc/en-us/articles/360037117472-Authentication-Profiles-for-Meetings-and-Webinars) applied to the user's account. \n* `recording_authentication` - Use this query parameter to view the [recording authentication settings](https://support.zoom.us/hc/en-us/articles/360037756671-Authentication-Profiles-for-Cloud-Recordings) applied to the user's account. \n* `meeting_security` - Use this query parameter to view the meeting security settings applied to the user's account.","required":false,"schema":{"type":"string","example":"meeting_security","enum":["meeting_authentication","recording_authentication","meeting_security"]}},{"name":"custom_query_fields","in":"query","description":"Provide the name of the field to filter the response. For example, if you provide `host_video` as the value of this field, you'll get a response similar to this. \n \n{\n schedule_meeting: {\n host_video: false\n }\n}\n \n To provide multiple values, separate them with commas, like `host_video,participant_video`.","required":false,"schema":{"type":"string","example":"host_video"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nUser settings returned.","content":{"application/json":{"schema":{"oneOf":[{"title":"User settings","type":"object","properties":{"audio_conferencing":{"type":"object","properties":{"toll_free_and_fee_based_toll_call":{"type":"object","properties":{"allow_webinar_attendees_dial":{"type":"boolean","description":"Whether webinar attendees can dial in through the account's **Toll-free and Fee-based Toll Call** phone numbers. This feature is only available in version 5.2.2 and higher.","example":true},"enable":{"type":"boolean","description":"Whether the user has the [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call#h_01F5190TYM8736XHQX683YQYSY) setting enabled.","example":true},"numbers":{"maxItems":100,"type":"array","description":"The user's **Toll-free and Fee-based Toll Call** phone number information.","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's [E.164 country calling code](https://en.wikipedia.org/wiki/List_of_country_calling_codes).","example":"86"},"country_code":{"type":"string","description":"The phone number's [country code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries).","example":"CN"},"country_name":{"type":"string","description":"The country name.","example":"China"},"display_number":{"maxLength":30,"type":"string","description":"The phone number's display number.","example":"+86 777 777 77"},"number":{"maxLength":30,"type":"string","description":"The phone number.","example":"777 777 77"}}}}},"description":"The user's [**Toll-free and Fee-based Toll Call**](https://support.zoom.us/hc/en-us/articles/360060950711-Enabling-Toll-free-and-Fee-based-Toll-Call#h_01F5190TYM8736XHQX683YQYSY) settings."},"toll_call":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the user has the [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F5190TYM8736XHQX683YQYSY) setting enabled.","example":true},"numbers":{"maxItems":100,"type":"array","description":"The user's **Toll Call** phone number information.","items":{"type":"object","properties":{"code":{"type":"string","description":"The phone number's [E.164 country calling code](https://en.wikipedia.org/wiki/List_of_country_calling_codes).","example":"86"},"country_code":{"type":"string","description":"The phone number's [country code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries).","example":"CN"},"country_name":{"type":"string","description":"The country name.","example":"China"},"display_number":{"maxLength":30,"type":"string","description":"The phone number's display number.","example":"+86 777 777 77"},"number":{"maxLength":30,"type":"string","description":"The phone number.","example":"777 777 77"}}}}},"description":"The user's [**Toll Call**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0066909#h_01F5190TYM8736XHQX683YQYSY) settings."},"call_me_and_invite_by_phone":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the user has the [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VGF2WET7M37JDCVHKYB9A) setting enabled.","example":true},"require_press_1_for_call_me":{"type":"string","description":"Require Call Me users to press 1 before being connected to the meeting. \n* `auto` - Automatically determine whether to require pressing 1 before connecting to the meeting. \n* `always` - Always require Call Me users to press 1 before connecting to the meeting. \n* `never` - Never require Call Me users to press 1 before connecting to the meeting.","example":"auto","enum":["auto","always","never"],"x-enum-descriptions":["Automatically determine whether to require pressing 1 before connecting to the meeting.","Always require Call Me users to press 1 before connecting to the meeting.","Never require Call Me users to press 1 before connecting to the meeting."]},"allow_webinar_attendees_call_me":{"type":"boolean","description":"Whether webinar attendees can use Call Me to connect audio. This feature is only available in version 5.2.2 and higher.","example":true},"call_out_countries":{"type":"object","properties":{"allowed_countries":{"type":"array","description":"The list of all available countries/regions that can be enabled for call out.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"selected_countries":{"type":"array","description":"The list of countries/regions that users can call out to.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}}},"description":"The user's call out countries/regions settings."}},"description":"The user's [**Call Me and Invite by Phone**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067414#h_01F53VGF2WET7M37JDCVHKYB9A) settings."},"personal_audio_conference":{"type":"boolean","description":"Whether the user has the [**Personal Audio Conference**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060449#h_01F5BPN225WWQGQMYJDKXZ80A5) setting enabled.","example":true},"participant_phone_masking":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether the user has the [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5HBEEEXRXR9SN5ZBNWN30) setting enabled.","example":true},"masking_type":{"type":"string","description":"The type of phone number masking pattern to apply. \n* `mask_default` - Default masking pattern (Example: 888****666). \n* `mask_first_5` - Mask first five digits (Example: *****66666). \n* `mask_except_last_4` - Mask everything except last four digits (Example: *****6666).","example":"mask_default","enum":["mask_default","mask_first_5","mask_except_last_4"],"x-enum-descriptions":["Default masking pattern (Example: 888****666).","Mask first five digits (Example: *****66666).","Mask everything except last four digits (Example: *****6666)."]}},"description":"The user's [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5HBEEEXRXR9SN5ZBNWN30) settings."},"global_dial_in_countries":{"type":"object","properties":{"allowed_countries":{"type":"array","description":"The list of all available countries/regions that can be selected for displaying dial-in numbers in the meeting invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"selected_countries":{"type":"array","description":"The list of selected countries/regions whose dial-in numbers will be listed in the email invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"include_toll_free":{"type":"boolean","description":"Whether to include toll-free numbers in the email invitation for the selected countries/regions.","example":true}},"description":"The user's [**Global Dial-in Countries/Regions**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0068094#h_01F5KKA1Y2CWNT35HF5C0JZY89) settings."}},"description":"The user's audio conference settings."},"email_notification":{"title":"User settings: Notification settings","type":"object","properties":{"alternative_host_reminder":{"type":"boolean","description":"When an alternative host is set or removed from a meeting.","example":true,"default":false},"cancel_meeting_reminder":{"type":"boolean","description":"When a meeting is cancelled.","example":true,"default":false},"cloud_recording_available_reminder":{"type":"boolean","description":"Whether to notify the host when a cloud recording is available.","example":true},"jbh_reminder":{"type":"boolean","description":"When attendees join meeting before host.","example":true,"default":false},"recording_available_reminder_alternative_hosts":{"type":"boolean","description":"Whether to notify any alternative hosts when a cloud recording is available.","example":true},"recording_available_reminder_schedulers":{"type":"boolean","description":"Whether to notify the person who scheduled the meeting or webinar for the host when a cloud recording is available.","example":true},"schedule_for_reminder":{"type":"boolean","description":"This setting notifies the host there is a meeting is scheduled, rescheduled, or cancelled.","example":true,"default":false}}},"feature":{"title":"User settings: Feature settings","type":"object","properties":{"cn_meeting":{"type":"boolean","description":"The host meeting in China.","example":true,"deprecated":true},"concurrent_meeting":{"type":"string","description":"The user's assigned [Concurrent Meeting](https://support.zoom.us/hc/en-us/articles/206122046) type: \n* `Basic` \n* `Plus` \n* `None` \n\n **Note:** This feature requires a Concurrent Meeting Basic or Plus plan subscription.","example":"Basic","enum":["Basic","Plus","None"],"x-enum-descriptions":["Concurrent Meeting Basic","Concurrent Meeting Plus","Concurrent Meeting disabled"]},"in_meeting":{"type":"boolean","description":"The host meeting in India.","example":true,"deprecated":true},"large_meeting":{"type":"boolean","description":"The large meeting feature.","example":true},"large_meeting_capacity":{"type":"integer","description":"The large meeting capacity. It can be 500 or 1000, depending on if the user has a large meeting capacity plan subscription or not.","example":500},"meeting_capacity":{"type":"integer","description":"The user's meeting capacity.","example":500},"webinar":{"type":"boolean","description":"The webinar feature.","example":true},"webinar_capacity":{"type":"integer","description":"The webinar capacity. It can be 100, 500, 1000, 3000, 5000 or 10000, depending on if the user has a webinar capacity plan subscription or not.","example":500},"zoom_events":{"type":"boolean","description":"Whether the Zoom Events feature is enabled for the user.","example":true},"zoom_events_capacity":{"type":"integer","description":"The user's Zoom Events plan capacity: `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`.","example":500,"enum":[500,1000,3000,5000,10000,20000,30000,50000]},"zoom_events_unlimited":{"type":"boolean","description":"Whether to enable the Zoom Events Unlimited feature for the user.","example":true},"zoom_events_unlimited_capacities":{"maxItems":9,"type":"array","description":"The capacity list of user's Zoom Events Unlimited plan - `100`, `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`. The first entry is always the largest.","example":[500,100],"items":{"type":"integer","example":500,"enum":[100,500,1000,3000,5000,10000,20000,30000,50000]}},"zoom_sessions_unlimited":{"type":"boolean","description":"Whether to enable the Zoom Sessions Unlimited feature for the user.","example":true,"deprecated":true},"zoom_sessions_unlimited_capacities":{"maxItems":9,"type":"array","description":"The capacity list of user's Zoom Sessions Unlimited plan - `100`, `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`. The first entry is always the largest.","example":[100,500],"deprecated":true,"items":{"type":"integer","example":500,"enum":[100,500,1000,3000,5000,10000,20000,30000,50000]}},"zoom_events_pay_per_attendee":{"type":"boolean","description":"Whether to enable the Zoom Events Pay Per Attendee feature for the user.","example":true},"zoom_sessions_pay_per_attendee":{"type":"boolean","description":"Whether to enable the Zoom Sessions Pay Per Attendee feature for the user.","example":true},"zoom_phone":{"type":"boolean","description":"The Zoom phone feature.","example":true},"zoom_iq_for_sales":{"type":"boolean","description":"Whether the user has a Zoom Revenue Accelerator license. For information about a Zoom Revenue Accelerator license, contact [Zoom Support](https://support.zoom.us/hc/en-us/articles/201362003).","example":false,"deprecated":true},"zoom_revenue_accelerator":{"type":"boolean","description":"Whether the user has a Zoom Revenue Accelerator license. For information about a Zoom Revenue Accelerator license, contact [Zoom Support](https://support.zoom.us/hc/en-us/articles/201362003).","example":false},"zoom_whiteboard":{"type":"boolean","description":"Whether the user has a Zoom Whiteboard license.","example":false},"zoom_whiteboard_plus":{"type":"boolean","description":"Whether the user has a Zoom Whiteboard Plus license.","example":false},"zoom_translated_captions":{"type":"boolean","description":"Whether the user has a Zoom Translated Captions license.","example":false},"zoom_customer_managed_key":{"type":"boolean","description":"Whether the user has a Zoom Customer Managed Key license.","example":false},"zoom_huddles":{"type":"boolean","description":"Whether the user has a Zoom Huddles license.","example":false,"deprecated":true},"zoom_quality_management":{"type":"boolean","description":"Whether the user has a Zoom Quality Management license.","example":false},"zoom_workforce_management":{"type":"boolean","description":"Whether the user has a Zoom Workforce Management license.","example":false},"zoom_scheduler":{"type":"boolean","description":"Whether the user has a Zoom Scheduler license.","example":false},"zoom_clips_plus":{"type":"boolean","description":"Whether the user has a Zoom Clips Plus license.","example":false},"zoom_mail_calendar":{"type":"boolean","description":"Whether the user has a Zoom Mail Calendar license.","example":false},"zoom_compliance_management":{"type":"boolean","description":"Whether the user has a Zoom Compliance Management license.","example":false},"zoom_docs":{"type":"boolean","description":"Whether the user has a Zoom Docs license.","example":false,"deprecated":true},"zoom_canvas":{"type":"boolean","description":"Whether the user has a Zoom Canvas license.","example":false},"license_info_list":{"type":"array","description":"A list of license information used to return the user's corresponding license type, license option, and license subscription reference ID.","items":{"type":"object","properties":{"license_type":{"type":"string","description":"The corresponding type for the user's existing license.","example":"ZOOM_WHITEBOARD","enum":["ZOOM_WHITEBOARD","ZOOM_TRANSLATED_CAPTIONS","ZOOM_SCHEDULER","ZOOM_CLIPS","ZOOM_VISITOR_MANAGEMENT","ZOOM_CMK","ZOOM_DOCS","ZOOM_REVENUE_ACCELERATOR","ZOOM_COMPLIANCE_MANAGEMENT","ZOOM_WORKFORCE_MANAGEMENT","ZOOM_QUALITY_MANAGEMENT","ZOOM_HEALTHCARE_CLINICAL_NOTES","ZOOM_EVENTS_NEW_SAAS","ZOOM_EVENTS_CONSUMPTION","ZOOM_WEBINARS_PLUS","ZOOM_WEBINARS_PLUS_CONSUMPTION","ZOOM_CUSTOM_AI_COMPANION","CX_INSIGHTS","ZOOM_ENHANCED_MEDIA","EDU_STUDENT"]},"license_option":{"type":"integer","description":"License option\nFor the parameters with **licenseType** as **ZOOM_WHITEBOARD:**\n `2` - Zoom Whiteboard.\n `65536` - Zoom Whiteboard Plus.\n\nFor the parameters with **licenseType** as **ZOOM_TRANSLATED_CAPTIONS**:\n `2048` - Zoom Translated Captions.\n \nFor the parameters with **licenseType** as **ZOOM_SCHEDULER**:\n `2199023255552` - Zoom Scheduler.\n\nFor the parameters with **licenseType** as **ZOOM_CLIPS**:\n `1` - Zoom Clips Plus.\n\nFor the parameters with **licenseType** as **ZOOM_VISITOR_MANAGEMENT**:\n `2147483648` - Zoom Visitor Management.\n\nFor the parameters with **licenseType** as **ZOOM_CMK**:\n `131072` - Zoom Customer Managed Key.\n\nFor the parameters with **licenseType** as **ZOOM_DOCS**:\n `281474976710656` - Zoom Docs.\n\n\nFor the parameters with **licenseType** as **ZOOM_CANVAS**:\n `281474976710656` - Zoom Canvas.\n\nFor the parameters with **licenseType** as **ZOOM_REVENUE_ACCELERATOR**:\n `1` - Zoom Revenue Accelerator.\n\nFor the parameters with **licenseType** as **ZOOM_COMPLIANCE_MANAGEMENT**:\n `8796093022208` - Zoom Compliance Management.\n `17592186044416` - Zoom Compliance Management Plus.\n\nFor the parameters with **licenseType** as **ZOOM_WORKFORCE_MANAGEMENT**:\n `549755813888` - Zoom Workforce Management.\n\nFor the parameters with **licenseType** as **ZOOM_QUALITY_MANAGEMENT**:\n `1099511627776` - Zoom Quality Management.\n `35184372088832` - Zoom Advanced Quality Management.\n\nFor the parameters with **licenseType** as **ZOOM_HEALTHCARE_CLINICAL_NOTES**:\n `512` - Zoom Workplace for Clinicians Unlimited.\n `4503599627370496` - Zoom Workplace for Clinicians - Pay Per Notes.\n\nFor the parameters with **licenseType** as **ZOOM_EVENTS_NEW_SAAS**:\n `2` - Zoom Events Unlimited - 100 attendees.\n `4` - Zoom Events Unlimited - 500 attendees.\n `8` - Zoom Events Unlimited - 1000 attendees.\n `16` - Zoom Events Unlimited - 3000 attendees.\n `32` - Zoom Events Unlimited - 5000 attendees.\n `64` - Zoom Events Unlimited - 10000 attendees.\n `128` - Zoom Events Unlimited - 20000 attendees.\n `256` - Zoom Events Unlimited - 30000 attendees.\n `512` - Zoom Events Unlimited - 50000 attendees.\n\nFor the parameters with **licenseType** as **ZOOM_EVENTS_CONSUMPTION**:\n `1` - Zoom Events - Pay Per Attendee.\n\nFor the parameters with **licenseType** as **ZOOM_WEBINARS_PLUS**:\n `2048` - Zoom Webinars Plus Unlimited - 100 attendees.\n `4096` - Zoom Webinars Plus Unlimited - 500 attendees.\n `8192` - Zoom Webinars Plus Unlimited - 1000 attendees.\n `16384` - Zoom Webinars Plus Unlimited - 3000 attendees.\n `32768` - Zoom Webinars Plus Unlimited - 5000 attendees.\n `65536` - Zoom Webinars Plus Unlimited - 10000 attendees.\n `131072` - Zoom Webinars Plus Unlimited - 20000 attendees.\n `262144` - Zoom Webinars Plus Unlimited - 30000 attendees.\n `524288` - Zoom Webinars Plus Unlimited - 50000 attendees.\n\nFor the parameters with **licenseType** as **ZOOM_WEBINARS_PLUS_CONSUMPTION**:\n `1024` - Zoom Webinars Plus - Pay Per Attendee.\n\nFor the parameters with **licenseType** as **ZOOM_CUSTOM_AI_COMPANION**:\n `256` - Zoom Custom AI Companion.\n `4096` - Zoom AI Companion.\n\nFor the parameters with **licenseType** as **CX_INSIGHTS_LEADER**:\n `1099511627776` - CX Insights Leader.\n\nFor the parameters with **licenseType** as **ZOOM_ENHANCED_MEDIA**:\n `4503599627370496` - Zoom Enhanced Media.\n\nFor the parameters with **licenseType** as **EDU_STANDARD_STUDENT**:\n `1152921504606846976` - Education Standard Student.","format":"int64","example":2,"enum":[1,2,4,8,16,32,64,128,256,512,1024,2048,4096,8192,16384,32768,65536,131072,262144,524288,2147483648,549755813888,1099511627776,2199023255552,8796093022208,17592186044416,35184372088832,281474976710656,4503599627370496]},"subscription_id":{"type":"string","description":"The subscription ID associated with the corresponding license.","example":"SUBREF-xxxxxx-xxxxxx"}}}},"zoom_webinars_plus_unlimited_capacities":{"maxItems":9,"type":"array","description":"The capacity list of user's Zoom Webinars Plus Unlimited plan - `100`, `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`. The first entry is always the largest.","example":[100,500],"items":{"type":"integer","example":500,"enum":[100,500,1000,3000,5000,10000,20000,30000,50000]}},"zoom_webinars_plus_unlimited":{"type":"boolean","description":"Whether to enable the Zoom Webinars Plus Unlimited feature for the user.","example":true}}},"in_meeting":{"title":"User settings: Meeting settings","type":"object","properties":{"allow_host_to_enable_focus_mode":{"type":"boolean","description":"Allow the host to enable [**Focus Mode**](https://support.zoom.us/hc/en-us/articles/360061113751-Using-focus-mode) when scheduling a meeting. This value defaults to `null`.","example":true},"allow_users_to_delete_messages_in_meeting_chat":{"type":"boolean","description":"If the value of this field is set to `true`, allow users to delete messages in the in-meeting chat.\n","example":true},"allow_live_streaming":{"type":"boolean","description":"Whether to allow live streaming.","example":true},"post_meeting_feedback":{"type":"boolean","description":"Whether to display a thumbs up or thumbs down feedback survey at the end of each meeting.","example":true},"whiteboard":{"type":"boolean","description":"Whether to enable the [**Zoom Whiteboard**](https://support.zoom.us/hc/en-us/articles/4410916881421) feature.","example":true},"allow_participants_chat_with":{"type":"integer","description":"Specify who participants can chat with:\n* `1` - The participant cannot use chat.\n* `2` - The participant can chat with the host and co-hosts only.\n * `3` - The participant can chat with other participants publicly.\n* `4` - The participant can chat with other participants publicly and privately.\n\n**Note:** This setting is only available with client versions 5.7.3 and above.","example":1,"enum":[1,2,3,4],"x-enum-descriptions":["No one","Host and co-hosts","Everyone","Everyone and anyone directly"]},"allow_users_save_chats":{"type":"integer","description":"This setting specifies how participants can save meeting chats:\n* `1` - Participants cannot save meeting chats.\n* `2` - Participants can only save host and co-host meeting chats.\n* `3` - Participants can save all meeting chats.","example":1,"enum":[1,2,3],"x-enum-descriptions":["Not allow","Host and co-hosts","Everyone"]},"annotation":{"type":"boolean","description":"This setting allows participants to use annotation tools.","example":true,"default":false},"attendee_on_hold":{"type":"boolean","description":"This setting allows host to put attendee on hold.\n\n**This field has been deprecated and is no longer supported.**","example":true,"deprecated":true,"default":false},"attention_mode_focus_mode":{"type":"boolean","description":"Whether the [**Focus Mode**](https://support.zoom.us/hc/en-us/articles/360061113751-Using-focus-mode) feature is enabled. When enabled, this feature only displays the host and co-hosts' video and profile pictures during a meeting. \n\n This value defaults to `false`.","example":true,"default":false},"auto_saving_chat":{"type":"boolean","description":"This setting auto saves all in-meeting chats.","example":true,"default":false},"breakout_room":{"type":"boolean","description":"This setting allows the host to split meeting participants into separate breakout rooms.","example":true,"default":false},"breakout_room_schedule":{"type":"boolean","description":"Whether the host can assign participants to breakout rooms when scheduling. This feature is only available in version 4.5.0 or higher.","example":true},"chat":{"type":"boolean","description":"This setting enables chat during meeting for all participants.","example":true,"default":false},"meeting_question_answer":{"type":"boolean","description":"This setting allows participants to ask questions for the host and participants to answer.","example":true},"closed_caption":{"type":"boolean","description":"This setting enables closed captions.","example":true,"default":false},"closed_captioning":{"type":"object","properties":{"auto_transcribing":{"type":"boolean","description":"Whether to allow a live transcription service to transcribe meetings.","example":true},"enable":{"type":"boolean","description":"Whether to allow the host to type closed captions or assign a participant or 3rd-party service to provide closed captioning.","example":true},"save_caption":{"type":"boolean","description":"Whether to allow participants to save closed captions or transcripts.","example":true},"third_party_captioning_service":{"type":"boolean","description":"Whether to allow the use of an API token to integrate with 3rd-party closed captioning services.","example":true},"view_full_transcript":{"type":"boolean","description":"Whether to allow the viewing of full transcripts in the in-meeting side panel.","example":true}},"description":"The information about the user's closed captioning settings."},"co_host":{"type":"boolean","description":"This setting allows the host to add co-hosts.","example":true,"default":false},"custom_data_center_regions":{"type":"boolean","description":"If set to `true`, you can [select data center regions](https://support.zoom.us/hc/en-us/articles/360042411451-Selecting-data-center-regions-for-hosted-meetings-and-webinars) to use for hosting your real-time meeting and webinar traffic. These regions can be provided in the `data_center_regions` field. If set to `false`, the regions cannot be customized and the default regions will be used.","example":true},"custom_live_streaming_service":{"type":"boolean","description":"Whether to allow custom live streaming.","example":true},"custom_service_instructions":{"type":"string","description":"The custom live streaming service instructions.","example":"The custom live streaming service instructions"},"data_center_regions":{"type":"array","description":"If the value of `custom_data_center_regions` is `true`, a comma-separated list of the following [data center regions](https://support.zoom.us/hc/en-us/articles/360059254691-Datacenter-abbreviation-list) to opt in to. \n* `AU` - Australia.\n* `LA` - Latin America. \n* `CA` - Canada. \n* `CN` - China. \n* `DE` - Germany. \n* `HK` - Hong Kong SAR. \n* `IN` - India. \n* `IE` - Ireland. \n* `TY` - Japan. \n* `MX` - Mexico. \n* `NL` - Netherlands. \n* `SG` - Singapore. \n* `US` - United States.","items":{"type":"string","example":"AU","enum":["AU","LA","CA","CN","DE","HK","IN","IE","TY","MX","NL","SG","US"]}},"disable_screen_sharing_for_host_meetings":{"type":"boolean","description":"This setting enables the **Disable desktop screen sharing for meetings you host** setting.","example":true},"disable_screen_sharing_for_in_meeting_guests":{"type":"boolean","description":"This setting enables the **Disable screen sharing when guests are in the meeting** setting.","example":true},"e2e_encryption":{"type":"boolean","description":"Zoom requires encryption for all data between the Zoom cloud, Zoom client, and Zoom Room. Require encryption for 3rd party endpoints (H323/SIP).","example":true},"entry_exit_chime":{"type":"string","description":"This setting plays sound when participants join or leave: \n `host` - When host joins or leaves. \n `all` - When any participant joins or leaves. \n `none` - No join or leave sound.","example":"all","default":"all","enum":["host","all","none"],"x-enum-descriptions":["when host joins/leaves","when any participant joins/leaves","no join/leave sound"]},"far_end_camera_control":{"type":"boolean","description":"This setting allows another user to take control of the camera.","example":true,"default":false},"feedback":{"type":"boolean","description":"This setting enables option to send feedback to Zoom at the end of the meeting.","example":true,"default":false},"file_transfer":{"type":"boolean","description":"Whether the [in-meeting file transfer](https://support.zoom.us/hc/en-us/articles/209605493-In-meeting-file-transfer) setting has been enabled for the user or not.","example":true},"group_hd":{"type":"boolean","description":"This setting enables group HD video in Meeting.","example":true,"default":false},"webinar_group_hd":{"type":"boolean","description":"This setting enables group HD video in Webinar.","example":true,"default":false},"join_from_desktop":{"type":"boolean","description":"This setting allows participants to join a meeting directly from their desktop browser. Note that the meeting experience from the desktop browser is limited.","example":true},"join_from_mobile":{"type":"boolean","description":"This setting allows participants to join a meeting directly from their mobile browser. Note that the meeting experience from the mobile browser is limited.","example":true},"language_interpretation":{"type":"object","properties":{"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"English"}},"enable_language_interpretation_by_default":{"type":"boolean","description":"Whether enable language interpretation by default.","example":true},"allow_participants_to_speak_in_listening_channel":{"type":"boolean","description":"Whether to allow participants to speak in listening channel.","example":true},"allow_up_to_25_custom_languages_when_scheduling_meetings":{"type":"boolean","description":"Whether to allow up to 25 custom languages when scheduling meetings.","example":true},"enable":{"type":"boolean","description":"This setting allows hosts to assign participants as interpreters who can interpret one language into another in real-time.","example":true},"languages":{"type":"array","description":"A list of system-supported languages.","items":{"type":"string","example":"English","enum":["English","Chinese","Japanese","German","French","Russian","Portuguese","Spanish","Korean"]}}},"description":"The information about the [language interpretation](https://support.zoom.us/hc/en-us/articles/360034919791-Using-Language-Interpretation-in-your-meeting-or-webinar) settings."},"sign_language_interpretation":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow hosts to assign participants as sign language interpreters who can interpret one language into another in real-time.","example":true},"enable_sign_language_interpretation_by_default":{"type":"boolean","description":"Whether to enable sign language interpretation view by default in scheduler.","example":true},"languages":{"type":"array","description":"A list of system-supported languages.","items":{"type":"string","example":"American","enum":["American","Chinese","French","German","Japanese","Russian","Brazilian","Spanish","Mexican","British"]}},"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"Language1"}}},"description":"This setting allows hosts to assign participants as sign language interpreters who can interpret one language into sign language in real-time. Hosts can assign interpreters when scheduling, or during the meeting itself. This feature is only available with version 5.11.3 or later."},"live_streaming_facebook":{"type":"boolean","description":"Whether to allow Facebook live streaming.","example":true},"live_streaming_youtube":{"type":"boolean","description":"Whether to allow YouTube live streaming.","example":true},"manual_captioning":{"type":"object","properties":{"allow_to_type":{"type":"boolean","description":"This setting allows the host to manually caption or let the host assign a participant to provide manual captioning.","example":true},"auto_generated_captions":{"type":"boolean","description":"This setting enables Zoom's [live transcription feature](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription#h_01FHGGHYJ4457H4GSZY0KM3NSB).","example":true},"full_transcript":{"type":"boolean","description":"This setting enables the viewing of full transcripts in the in-meeting side panel.","example":true},"manual_captions":{"type":"boolean","description":"This setting [enables manual closed captioning](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription).","example":true},"save_captions":{"type":"boolean","description":"This setting allows participants to [save closed captions or transcripts](https://support.zoom.us/hc/en-us/articles/360060958752). \n\n **Note:** If the `full_transcript` field is set to `false`, participants **cannot** save captions.","example":true},"third_party_captioning_service":{"type":"boolean","description":"This setting allows the use of an API token to integrate with a [3rd-party device](https://support.zoom.us/hc/en-us/articles/115002212983) to provide closed captioning.","example":true}},"description":"The information about manual captioning settings."},"meeting_reactions":{"type":"boolean","description":"This setting allows meeting participants to [communicate using the emoji reactions](https://support.zoom.us/hc/en-us/articles/115001286183-Nonverbal-feedback-and-meeting-reactions) located in the **Reactions** menu in the meeting toolbar.","example":true},"meeting_reactions_emojis":{"type":"string","description":"This setting enables you to choose from these meeting reaction options.\n* `all` - All emojis: Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.\n* `selected` - Selected emojis: Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration).","example":"all","enum":["all","selected"],"x-enum-descriptions":["Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.","Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration)."]},"allow_host_panelists_to_use_audible_clap":{"type":"boolean","description":"Whether to allow host and panelist to use audible clap.","example":true},"webinar_reactions":{"type":"boolean","description":"You can set this field to true to use [webinar reactions](https://support.zoom.us/hc/en-us/articles/4803536268429).","example":true},"meeting_survey":{"type":"boolean","description":"This setting allows the host to present a survey to participants once a meeting has ended. This feature is only available in version 5.7.3 or higher.","example":true},"non_verbal_feedback":{"type":"boolean","description":"This setting enables non-verbal feedback through screens.","example":true,"default":false},"polling":{"type":"boolean","description":"This setting adds polls to the meeting controls.","example":true,"default":false},"private_chat":{"type":"boolean","description":"This setting enables 1:1 private chat between participants during meetings.","example":true,"default":false},"record_play_voice":{"type":"boolean","description":"This setting records and plays their own voice.","example":true},"remote_control":{"type":"boolean","description":"This setting enables remote control during screensharing.","example":true,"default":false},"remote_support":{"type":"boolean","description":"This setting allows host to provide 1:1 remote support to a participant.","example":true,"default":false},"request_permission_to_unmute_participants":{"type":"boolean","description":"Whether the [**Request permission to unmute participants**](https://support.zoom.us/hc/en-us/articles/203435537-Muting-and-unmuting-participants-in-a-meeting#h_01EGK4XFWS1SJGZ71MYGKF7260) option has been enabled for the user or not.","example":true},"screen_sharing":{"type":"boolean","description":"This setting allows host and participants to share their screen or content during meetings\n","example":true},"share_dual_camera":{"type":"boolean","description":"This setting shares dual camera.","example":true,"deprecated":true,"default":false},"show_a_join_from_your_browser_link":{"type":"boolean","description":"The setting allows participants to join a meeting directly from their browser and bypass the Zoom application download process. This is useful for participants who cannot download, install, or run applications. Note that the meeting experience from the browser is limited.","example":true},"show_meeting_control_toolbar":{"type":"boolean","description":"This setting allows you to always show meeting controls during a meeting.","example":true},"slide_control":{"type":"boolean","description":"This setting allows the person sharing during a presentation to allow others to control the slide presentation. This feature is only available in version 5.8.3 or higher.","example":true},"unchecked_data_center_regions":{"type":"array","description":"If the value of `custom_data_center_regions` is `true`, a comma-separated list of the following [data center regions](https://support.zoom.us/hc/en-us/articles/360059254691-Datacenter-abbreviation-list) to **not** opt in to: \n* `EU` - Europe. \n* `HK` - Hong Kong. \n* `AU` - Australia. \n* `IN` - India. \n* `LA` - Latin America. \n* `TY` - Tokyo. \n* `CN` - China. \n* `US` - United States. \n* `CA` - Canada.","items":{"type":"string","example":"US","enum":["EU","HK","AU","IN","TY","CN","US","CA","DE","NL","LA"]}},"virtual_background":{"type":"boolean","description":"This setting enables virtual background.","example":true,"default":false},"virtual_background_settings":{"type":"object","properties":{"allow_upload_custom":{"type":"boolean","description":"This setting allows the user to upload custom backgrounds.","example":true},"allow_videos":{"type":"boolean","description":"This setting allows the use of videos for virtual backgrounds.","example":true},"enable":{"type":"boolean","description":"This setting enables virtual background.","example":true},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the file.","example":"sdv34sa0jp-h80y98GBU"},"is_default":{"type":"boolean","description":"Whether or not this file is the default virtual background file.","example":true},"name":{"type":"string","description":"The file name.","example":"example.png"},"size":{"type":"integer","description":"The file size.","example":1342},"type":{"type":"string","description":"The file type.","example":"image"}}}}},"description":"The settings to manage virtual background."},"waiting_room":{"type":"boolean","description":"This setting enables the waiting room. If enabled, attendees can only join after host approves.","example":true,"default":false},"webinar_chat":{"type":"object","properties":{"allow_attendees_chat_with":{"type":"integer","description":"This setting indicates who webinar attendees can chat with.\n* `1` - No one.\n* `2` - Host and all panelists.\n* `3` - Everyone.","example":2,"enum":[1,2,3]},"allow_auto_save_local_chat_file":{"type":"boolean","description":"Automatically saves chat messages to a local file on the host's computer when the webinar ends.","example":true},"allow_panelists_chat_with":{"type":"integer","description":"This setting indicates who the webinar panelists can chat with. \n* `1` - Host and all panelists. \n* `2` - Everyone.","example":2,"enum":[1,2]},"allow_panelists_send_direct_message":{"type":"boolean","description":"This setting allows webinar panelists to send direct messages to other panelists.","example":true},"allow_users_save_chats":{"type":"integer","description":"This setting indicates how webinar attendees can save chats. \n* `0` - Attendees cannot save chats. \n* `1` - Attendees can only save host and panelist chats. \n* `2` - Attendees can save all chats.","example":1,"enum":[0,1,2]},"default_attendees_chat_with":{"type":"integer","description":"By default, it indicates who the webinar attendees can chat with.\n* `1` - Host and all panelists.\n* `2` - Everyone.","example":1,"enum":[1,2]},"enable":{"type":"boolean","description":"This setting allows the webinar participants to send chat messages.","example":true}}},"webinar_live_streaming":{"type":"object","properties":{"custom_service_instructions":{"type":"string","description":"The specific instructions to allow your account's meeting hosts to configure a custom live stream.","example":"The specific instructions"},"enable":{"type":"boolean","description":"Whether webinar live streaming is enabled.","example":true},"live_streaming_reminder":{"type":"boolean","description":"Whether to notify users to watch the live stream. This does not apply to custom RTMP (real-time messaging protocol).","example":true},"live_streaming_service":{"type":"array","description":"The available live streaming services:\n* `facebook`\n* `workplace_by_facebook`\n* `youtube`\n* `custom_live_streaming_service`","items":{"type":"string","example":"workplace_by_facebook","enum":["facebook","workplace_by_facebook","youtube","custom_live_streaming_service"],"x-enum-descriptions":["Facebook","Workplace by Facebook","YouTube","Custom Live Streaming Service"]}}}},"meeting_polling":{"type":"object","properties":{"advanced_polls":{"type":"boolean","description":"Whether to allow the host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. The host can also set the correct answers for quizzes they create.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow host to upload an image for each question.","example":true},"enable":{"type":"boolean","description":"Whether to allow the host to add polls before or during a meeting.","example":true}},"description":"The information about the account's meeting polling settings."},"webinar_polling":{"type":"object","properties":{"advanced_polls":{"type":"boolean","description":"This setting allows the host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. Hosts can also set the correct answers for quizzes they create.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow host to upload an image for each question.","example":true},"enable":{"type":"boolean","description":"This setting allows the host to add polls before or during a webinar.","example":true}},"description":"The information about the user's webinar polling settings."},"webinar_survey":{"type":"boolean","description":"This setting allows the host to present surveys to attendees once a webinar has ended.","example":true},"who_can_share_screen":{"type":"string","description":"This setting indicates who can share their screen or content during meetings. The value can be one of the following: \n \n`host`: Only host can share the screen. \n \n`all`: Both hosts and attendees can share their screen during meetings. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"all","enum":["host","all"]},"who_can_share_screen_when_someone_is_sharing":{"type":"string","description":"This setting indicates who is allowed to start sharing screen when someone else in the meeting is sharing their screen. The value can be one of the following: \n \n`host`: Only a host can share the screen when someone else is sharing. \n \n`all`: Anyone in the meeting is allowed to start sharing their screen when someone else is sharing. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"host","enum":["host","all"]},"participants_share_simultaneously":{"type":"string","description":"This setting indicates how many participants can share at the same time. The value can be one of the following: \n \n`one`: Only one participant can share at a time\n. \n \n`multiple`: Multiple participants can share simultaneously (dual monitors recommended).","example":"multiple","enum":["multiple","one"]},"workplace_by_facebook":{"type":"boolean","description":"Whether to allow Workplace by Facebook live streaming.","example":true},"transfer_meetings_between_devices":{"type":"boolean","description":"Users can move to a new device without leaving the meeting they're in.","example":true},"allow_show_zoom_windows":{"type":"boolean","description":"This setting enables the [**Show Zoom windows during screen share**](https://support.zoom.us/hc/en-us/articles/360061383571-Showing-Zoom-windows-during-screen-share) feature.","example":false},"meeting_summary_with_ai_companion":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow hosts to generate a summary.","example":true},"auto_enable":{"type":"boolean","description":"Whether to turn on meeting summary automatically when meetings start","example":true},"who_will_receive_summary":{"type":"integer","description":"Defines who will receive a summary after this meeting. \n* `1` - Only meeting host.\n* `2` - Only meeting host, co-hosts, and alternative hosts. \n* `3` - Only meeting host and meeting invitees in our organization. \n* `4` - All meeting invitees including those outside of our organization.","example":1,"enum":[1,2,3,4]}},"description":"As a host, you can generate a summary. Summaries are sent after the meeting has ended based on the share options."},"webinar_summary_with_ai_companion":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow webinar hosts to generate a summary.","example":true},"auto_enable":{"type":"boolean","description":"Whether to automatically turn on webinar summary when webinars start.","example":true},"who_will_receive_summary":{"type":"integer","description":"Defines who will receive a summary after the webinar. \n* `1` - Only the webinar host.\n* `2` - Only the webinar host, co-hosts, and panelists in your organization.\n* `3` - The webinar host, co-hosts, and all panelists, including those outside your organization.","example":1,"enum":[1,2,3]}},"description":"As a webinar host, you can generate a summary. Summaries are sent after the webinar ends based on the share options."},"ai_companion_questions":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow hosts and invited participants to ask questions to AI Companion during a meeting.","example":true},"auto_enable":{"type":"boolean","description":"Whether to automatically allow access when the meeting starts","example":true},"who_can_ask_questions":{"type":"integer","description":"Defines who can ask questions about this meeting's transcript. \n* `1` - All participants and invitees. \n* `2` - All participants only from when they join. \n* `3` - Only meeting host. \n* `4` - Participants and invitees in our organization. \n* `5` - Participants in our organization only from when they join.","example":1,"enum":[1,2,3,4,5]}},"description":"Allow hosts and invited participants to ask questions to AI Companion during a meeting. Questions are answered based on the conversation transcript."},"webinar_ai_companion_questions":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow webinar hosts and panelists to ask questions to AI Companion during a webinar.","example":true},"auto_enable":{"type":"boolean","description":"Whether to automatically allow access when the webinar starts.","example":true},"who_can_ask_questions":{"type":"integer","description":"Defines who can ask questions about the webinar's transcript. \n* `0` - Hosts and all panelists. \n* `1` - Hosts and all panelists in your organization. \n* `2` - Only the webinar host, co-hosts, and alternative hosts. \n* `3` - All participants.","example":1,"enum":[0,1,2,3]}},"description":"Allow webinar hosts and panelists to ask questions to AI Companion during a webinar. Questions are answered based on the conversation transcript."}}},"profile":{"title":"Profile","type":"object","properties":{"recording_storage_location":{"type":"object","properties":{"allowed_values":{"type":"array","description":"Users can choose the country to store their recorded content. Content can include meeting, webinar, and phone recordings, as well as voicemail, transcripts, and custom greeting prompts. See [Managing the Communications Content storage location](https://support.zoom.us/hc/en-us/articles/360050781131) for details.\n\nProvide abbreviated country codes as the value for this field. See the [Countries abbreviation list](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) for details.","items":{"type":"string","example":"US"}},"value":{"type":"string","description":"The abbreviated country code.","example":"US"}}}}},"recording":{"title":"User settings: Recording settings","type":"object","properties":{"ask_host_to_confirm_disclaimer":{"type":"boolean","description":"This setting asks the host to confirm the disclaimer.","example":true},"ask_participants_to_consent_disclaimer":{"type":"boolean","description":"This field can be used if `recording_disclaimer` is set to true. This field indicates whether or not you would like to ask participants for consent when a recording starts. The value can be one of the following: \n \n* `true`: Ask participants for consent when a recording starts. \n \n* `false`: Do not ask participants for consent when a recording starts.","example":true},"auto_delete_cmr":{"type":"boolean","description":"The auto delete cloud recordings setting.","example":true,"default":false},"auto_delete_cmr_days":{"type":"integer","description":"When the `auto_delete_cmr` value is `true`, this value is the number of days before the auto-deletion of cloud recordings. \n* `30` - 30 days. \n* `60` - 60 days. \n* `90` - 90 days. \n* `120` - 120 days.","example":90,"enum":[30,60,90,120],"x-enum-descriptions":["30 days.","60 days.","90 days.","120 days."]},"record_files_separately":{"type":"object","properties":{"active_speaker":{"type":"boolean","description":"This setting records the active speaker only.","example":true},"gallery_view":{"type":"boolean","description":"This setting records the gallery view only.","example":true},"shared_screen":{"type":"boolean","description":"This setting records the shared screen only.","example":true}},"description":"The account's [**Record active speaker, gallery view and shared screen separately**](https://support.zoom.us/hc/en-us/articles/360060316092-Changing-basic-and-advanced-cloud-recording-settings#h_01F4CYJTCTXNS2MXH00W9EFG6R) settings."},"display_participant_name":{"type":"boolean","description":"This setting displays the participants' names in the recording.","example":true},"recording_thumbnails":{"type":"boolean","description":"This setting records thumbnails of the presenter when they are sharing their screen.","example":true},"optimize_recording_for_3rd_party_video_editor":{"type":"boolean","description":"This setting optimizes recordings for a third-party video editor. This may increase the file size and the time it takes to generate recording files.","example":true},"recording_highlight":{"type":"boolean","description":"This setting enables the [recording highlights](https://support.zoom.us/hc/en-us/articles/360060802432) feature.","example":true,"deprecated":true},"save_panelist_chat":{"type":"boolean","description":"This setting saves the panelist chat to the recording. This setting also saves messages sent by panelists during a webinar to either all panelists or all panelists and attendees to the recording.","example":true},"save_poll_results":{"type":"boolean","description":"This setting saves poll results shared during the meeting or webinar. It also includes poll results shared during the meeting or webinar.","example":true},"save_close_caption":{"type":"boolean","description":"This setting saves [closed captions](https://support.zoom.us/hc/en-us/articles/207279736) as a VTT (Video Track Text) file.","example":true},"auto_recording":{"type":"string","description":"The automatic recording: \n `local` - Record on local. \n `cloud` - Record on cloud. \n `none` - Disabled.","example":"cloud","default":"local","enum":["local","cloud","none"],"x-enum-descriptions":["Record on local","Record on cloud","Disabled"]},"cloud_recording":{"type":"boolean","description":"The cloud recording.","example":true,"default":false},"host_pause_stop_recording":{"type":"boolean","description":"The host can pause or stop the auto recording in the cloud.","example":true,"default":false},"ip_address_access_control":{"type":"object","properties":{"enable":{"type":"boolean","description":"If set to `true`, the cloud recordings of this account can only be accessed by the IP addresses defined in the `ip_addresses_or_ranges` property.\n\n","example":true},"ip_addresses_or_ranges":{"type":"string","description":"The IP addresses or ranges that have access to the cloud recordings. Separate multiple IP ranges with comma. Use n.n.n.n, n.n.n.n/n or n.n.n.n - n.n.n.n syntax where n is a number.\n\nExample: `46.33.24.184, 48.99.100.2/25` or `200.181.108.17 - 220.181.108.157`\n\n","example":"46.33.24.184"}},"description":"This setting allows the cloud recording access only from specific IP address ranges.\n"},"local_recording":{"type":"boolean","description":"The local recording.","example":true},"record_audio_file":{"type":"boolean","description":"This setting records one audio file for all participants.","example":true,"default":false},"record_gallery_view":{"type":"boolean","description":"This setting records the gallery view.","example":true,"default":false},"record_speaker_view":{"type":"boolean","description":"This setting records the active speaker view.","example":true,"default":false},"recording_audio_transcript":{"type":"boolean","description":"The audio transcript.","example":true},"recording_disclaimer":{"type":"boolean","description":"The setting shows a disclaimer to participants before a recording starts\nThis field has been deprecated. The replacement field is recording_notification_for_zoom_client.","example":true,"deprecated":true},"smart_recording":{"type":"object","properties":{"create_recording_highlights":{"type":"boolean","description":"By selecting this option, the meeting details in the audio transcript will be highlighted. Hosts can modify highlighted sections and generate a video summary (highlighted sections may have a 3-second offset) based on these sections. The summary is for informational purposes only and may not be complete.","example":true},"create_smart_chapters":{"type":"boolean","description":"By selecting this option, your recording will have chapters with overview. Hosts can edit the chapters.","example":true},"create_next_steps":{"type":"boolean","description":"By selecting this option, there will be a summary of actions to take after the recorded meeting.","example":true}},"description":"By selecting this option, your recording will have meeting smart chapters, and next steps. You are directing Zoom to access, process, and use your account's recording data for the purpose of analysis and insights."},"recording_password_requirement":{"type":"object","properties":{"have_letter":{"type":"boolean","description":"The passcode must contain at least one alphabetical letter (a, b, c..).","example":true},"have_number":{"type":"boolean","description":"The passcode must contain at least one number(1, 2, 3..).","example":true},"have_special_character":{"type":"boolean","description":"The passcode must contain at least one special character(!, @, #..).","example":true},"length":{"maximum":10,"type":"integer","description":"The minimum required length for the passcode.","example":10},"only_allow_numeric":{"type":"boolean","description":"The passcode must contain only numeric characters.","example":true}},"description":"This object represents the minimum passcode requirements set for recordings via Account Recording Settings."},"save_chat_text":{"type":"boolean","description":"This setting saves chat text from the meeting.","example":true,"default":false},"show_timestamp":{"type":"boolean","description":"This setting shows the timestamp on the video.","example":true,"default":false},"recording_notification_for_zoom_client":{"type":"object","properties":{"disclaimer_to_participants":{"type":"string","description":"Child setting name is [Show a disclaimer to participants when a recording starts], the value is option name you selected.","example":"All participants or Guest only"},"play_voice_prompt":{"type":"string","description":"Child setting name is [Play voice prompt for], the value is option name you selected.","example":" All participants or Guest only or No one"},"ask_host_to_confirm":{"type":"boolean","description":"Child setting name is [Ask host to confirm before starting a recording], the value is option name you selected","example":true}},"description":"setting name: Recording notifications - Zoom clients"},"allow_revenue_accelerator_manage_recording_separate_auto_delete":{"type":"boolean","description":"Allow Zoom Revenue Accelerator to manage recording files with separate auto-delete settings","example":true},"cloud_recording_permanently_deleted":{"type":"object","properties":{"cloud_recording_permanently_deleted_from_trash":{"type":"boolean","description":"Main setting value","example":true},"email_reminder_type":{"type":"string","description":"Selected email reminder","example":"Weekly digest on Monday","enum":["7 days before deletion","Weekly digest on Monday"]}},"description":"When the cloud recording is going to be permanently deleted from trash"},"allow_cmr_3rd_party_bot":{"type":"boolean","description":"Allow 3rd-party recording","example":true},"water_marker_recording":{"type":"boolean","description":"add water marker for recording","example":true},"viewer_see_transcript":{"type":"boolean","description":"Viewers can see the transcript","example":true},"allow_invitees_access_recordings_without_passcode":{"type":"boolean","description":"Allow invitees to access recordings without the passcode","example":true},"recording_as_on_demand":{"type":"boolean","description":"Set recording as on-demand by default","example":true},"recording_notifications_phone_users":{"type":"object","properties":{"require_press_one_consent_to_record":{"type":"boolean","description":"Require phone-only users to press 1 to consent to being recorded","example":true},"multiple_notifications_phone_users":{"type":"boolean","description":"Multiple notifications for phone users","example":true}},"description":"Recording notifications - Phone users"},"upload_recording":{"type":"boolean","description":"Upload recording to the cloud","example":true},"allow_add_cloud_recordings_to_zoom_clips":{"type":"boolean","description":"Allow users to add cloud recordings to Zoom Clips","example":true},"allow_share":{"type":"boolean","description":"Allow cloud recording sharing","example":true},"viewer_see_chat":{"type":"boolean","description":"Viewers see chat","example":true},"authenticated_view_cloud_recoding":{"type":"object","properties":{"authenticated_can_view_cloud_recordings":{"type":"boolean","description":"Main setting value","example":true},"default_authenticate_content":{"type":"string","description":"Default authentication option","example":"Signed-in users in my account","enum":["Signed-in users in my account","Sign in to Zoom","Sign in to Zoom with specified domains","Sign in to external Single Sign-On (SSO)","Only people with access"]}},"description":"Require users to authenticate before viewing cloud recordings"},"notification_subscription_url_when_recording_available":{"type":"boolean","description":"Push notification to subscription URL when a cloud recording is available","example":true},"recording_storage_email_notifications":{"type":"boolean","description":"Recording storage email notifications","example":true},"local_recording_options":{"type":"object","properties":{"internal_meeting_participants":{"type":"boolean","description":"Internal meeting participants","example":true},"internal_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"external_meeting_participants":{"type":"boolean","description":"External meeting participants","example":true},"external_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"participants_with_specified_domains":{"type":"boolean","description":"Meeting participants with specified domains","example":true},"participants_with_specified_domains_content":{"type":"string","description":"Enter the domain information","example":"zoom.us"},"participants_specified_domains_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"save_chat_messages":{"type":"boolean","description":"Save chat messages from the meeting / webinar","example":true},"save_closed_caption":{"type":"boolean","description":"Save closed caption as a VTT file","example":true}},"description":"all sub-options for local recording"},"embed_passcode_in_shareable_link":{"type":"boolean","description":"Embed passcode in the shareable link for one-click access","example":true}}},"schedule_meeting":{"title":"User settings: Meeting settings","type":"object","properties":{"audio_type":{"type":"string","description":"This setting determines how participants can join the audio portion of the meeting: \n `both` - Telephony and VoIP. \n `telephony` - Audio PSTN telephony only. \n `voip` - VoIP only. \n `thirdParty` - Third party audio conference.","example":"telephony","default":"voip","enum":["both","telephony","voip","thirdParty"],"x-enum-descriptions":["Telephony and VoIP","Audio PSTN telephony only","VoIP only","3rd party audio conference"]},"default_password_for_scheduled_meetings":{"type":"string","description":"The passcode for already scheduled meetings\n","example":"1213434"},"embed_password_in_join_link":{"type":"boolean","description":"This setting encrypts the meeting passcode and includes it in the join meeting link to allow participants to join with just one click without having to enter the passcode.\n ","example":true},"force_pmi_jbh_password":{"type":"boolean","description":"This setting requires a passcode for personal meetings if attendees can join before host.","example":true},"host_video":{"type":"boolean","description":"This setting starts meetings with host video on.","example":true},"join_before_host":{"type":"boolean","description":"This setting joins the meeting before host arrives.","example":true},"meeting_password_requirement":{"type":"object","properties":{"consecutive_characters_length":{"type":"integer","example":8,"enum":[0,4,5,6,7,8]},"have_letter":{"type":"boolean","description":"The passcode must contain at least 1 letter (such as a,b,c...).\n","example":true},"have_number":{"type":"boolean","description":"The passcode must contain at least 1 number (such as 1,2,3...).","example":true},"have_special_character":{"type":"boolean","description":"The passcode must have at least one special character (!,@,#...).","example":true},"have_upper_and_lower_characters":{"type":"boolean","description":"The passcode must include both uppercase and lowercase characters.","example":true},"length":{"type":"integer","description":"The minimum length that the meeting/webinar passcode must have.","example":10},"only_allow_numeric":{"type":"boolean","description":"The passcode must only contain numbers and no other characters.","example":true},"weak_enhance_detection":{"type":"boolean","description":"This setting informs users if the provided passcode is weak.","example":true}},"description":"The account wide meeting or webinar [passcode requirements](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604)."},"participants_video":{"type":"boolean","description":"This setting starts meetings with participants video on.","example":true},"personal_meeting":{"type":"boolean","description":"The personal meeting setting. \n\n \n`true` - Indicates that the **Enable [Personal Meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi)** setting is turned on. Users can choose to use a PMI for their meetings. \n\n \n`false` - Indicates that the **Enable Personal Meeting ID** setting is [turned off](https://support.zoom.us/hc/en-us/articles/201362843-Personal-meeting-ID-PMI-and-personal-link#h_aa0335c8-3b06-41bc-bc1f-a8b84ef17f2a). If this setting is disabled, meetings that were scheduled with PMI will be invalid. Scheduled meetings will need to be manually updated.\nFor Zoom Phone only:If a user has been assigned a desk phone, **Elevate to Zoom Meeting** on desk phone will be disabled.\n\n\n","example":true},"pmi_password":{"type":"string","description":"The PMI passcode.\n","example":"113332424"},"pstn_password_protected":{"type":"boolean","description":"This setting generates and requires a passcode for participants who join by phone.","example":true},"require_password_for_instant_meetings":{"type":"boolean","description":"This setting requires a passcode for instant meetings. If you use PMI for your instant meetings, this option will be disabled. This setting is always enabled for free accounts and Pro accounts with a single host and cannot be modified for these accounts.\n","example":true},"require_password_for_pmi_meetings":{"type":"string","description":"This setting requires a passcode for the Personal Meeting ID (PMI). This setting is always enabled for free accounts and Pro accounts with a single host and cannot be modified for these accounts.\n","example":"jbh_only","enum":["jbh_only","all","none"],"x-enum-descriptions":["Only meetings with Join Before Host enabled","All meetings using PMI","Disabled"]},"require_password_for_scheduled_meetings":{"type":"boolean","description":"This setting requires a passcode for meetings which have already been scheduled.\n","example":true},"require_password_for_scheduling_new_meetings":{"type":"boolean","description":"This setting requires a passcode when scheduling new meetings.This setting is always enabled for free accounts and Pro accounts with a single host and cannot be modified for these accounts.\n","example":true},"use_pmi_for_instant_meetings":{"type":"boolean","description":"This setting uses a [Personal Meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi) when starting an instant meeting.","example":true},"use_pmi_for_scheduled_meetings":{"type":"boolean","description":"The usser can use a [Personal Meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi) when scheduling a meeting.","example":true},"continuous_meeting_chat":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable the **Enable continuous meeting chat** setting.","example":true},"can_add_external_users":{"type":"boolean","description":"Whether to enable the **External users can be added** setting.","example":true,"deprecated":true},"auto_add_invited_external_users":{"type":"boolean","description":"Whether to enable the **Automatically add invited external users** setting.","example":true,"deprecated":true},"support_instant_meetings":{"type":"boolean","description":"Whether to enable the **Enable continuous meeting chat** setting for instant meetings.","example":true},"support_scheduled_meetings":{"type":"boolean","description":"Whether to enable the **Enable continuous meeting chat** setting for scheduled meetings.","example":true}},"description":"Information about the **Enable continuous meeting chat** feature."}}},"telephony":{"title":"User settings: Meeting settings","type":"object","properties":{"audio_conference_info":{"maxLength":2048,"type":"string","description":"The third-party audio conference info.","example":"test","default":""},"show_international_numbers_link":{"type":"boolean","description":"This setting shows the international numbers link on the invitation email.","example":true},"telephony_regions":{"type":"object","properties":{"allowed_values":{"type":"array","description":"The telephony region options provided by Zoom to select from.","items":{"type":"string","example":"CNTB"}},"selection_values":{"type":"string","description":"The account's selected telephony regions that indicate where most participants call into or call from during a meeting.","example":"USTB"}},"description":"This setting indicates where most of the participants call into or call from during a meeting."},"third_party_audio":{"type":"boolean","description":"The third party audio conference.","example":true}},"description":"User Settings: Telephony."},"tsp":{"title":"User settings: TSP settings","type":"object","properties":{"call_out":{"type":"boolean","description":"The call out.","example":true},"call_out_countries":{"type":"array","description":"The call out by countries or regions.","items":{"type":"object"}},"show_international_numbers_link":{"type":"boolean","description":"This setting shows the international numbers link on the invitation email.","example":true},"global_dial_in_countries":{"type":"object","properties":{"allowed_countries":{"type":"array","description":"The list of all available countries/regions that can be selected for displaying dial-in numbers in the meeting invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The code of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"selected_countries":{"type":"array","description":"The list of selected countries/regions whose dial-in numbers will be listed in the email invitation. You can adjust the order that the dial-in numbers appear in the email invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The code of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}}},"description":"The user's **Global Dial-in Countries/Regions** settings."}},"description":"Account Settings: TSP."},"whiteboard":{"title":"User settings - Whiteboard settings.","type":"object","properties":{"out_meeting_advanced_whiteboard":{"type":"boolean","description":"This setting is enables an out-of-meeting whiteboard.","example":true},"in_meeting_advanced_whiteboard":{"type":"boolean","description":"This setting is enables an in-meeting whiteboard","example":true}},"description":"Account settings - Whiteboard."},"general_setting":{"title":"General settings.","type":"object","properties":{"auto_zoom_room_proximity_connect":{"type":"boolean","description":"Allow automatic direct sharing and connecting to Zoom Rooms using ultrasonic proximity signal.","example":true}},"description":"General settings."}}},{"title":"User Meeting and Recording Authentication Settings","type":"object","properties":{"authentication_options":{"type":"object","properties":{"meeting_authentication":{"type":"object","properties":{"allow_authentication_exception":{"type":"boolean","description":"Whether the [**Allow authentication exception**](https://support.zoom.us/hc/en-us/articles/360037117472#h_01F13A9N1FQFNVESC9C21NRHXY) setting is enabled. This lets hosts invite users who can bypass authentication.","example":true},"authentication_options":{"type":"array","description":"The user's [**Meeting Authentication Options**](https://support.zoom.us/hc/en-us/articles/360060549492-Allowing-only-authenticated-users-in-meetings#h_01F51KGPWJNQBDMFSJ3ZJQ4AA2) settings.","items":{"type":"object","properties":{"default_option":{"type":"boolean","description":"Whether the authentication option is the default authentication option.","example":true},"domains":{"type":"string","description":"A comma-separated list of approved authentication domains.","example":"example.com"},"id":{"type":"string","description":"The authentication option's ID.","example":"efq4g43gqwrvwr-20f2432fr"},"name":{"type":"string","description":"The authentication option's name.","example":"The authentication option's name"},"type":{"type":"string","description":"The authentication type. \n* `enforce_login` - Only users logged in to Zoom can join meetings. \n* `enforce_login_with_domains` - Only users from specific domains can join meetings. The list of domains is defined in the `domains` field. \n* `enforce_login_with_same_account` - Only the Zoom account's users can join meetings.","example":"enforce_login_with_same_account","enum":["enforce_login","enforce_login_with_domains","enforce_login_with_same_account"]},"visible":{"type":"boolean","description":"Whether the authentication option is visible.","example":true}}}},"meeting_authentication":{"type":"boolean","description":"Whether only authenticated users can join meetings.","example":true}},"description":"The user's [meeting authentication settings](https://support.zoom.us/hc/en-us/articles/360037117472)."},"recording_authentication":{"type":"object","properties":{"authentication_options":{"type":"array","description":"The user's authentication options.","items":{"type":"object","properties":{"default_option":{"type":"boolean","description":"Whether the authentication option is the default authentication option.","example":true},"domains":{"type":"string","description":"A comma-separated list of approved authentication domains.","example":"example.com"},"id":{"type":"string","description":"The authentication option's ID.","example":"svqeg34g43g43g4343g4343g4334"},"name":{"type":"string","description":"The authentication option's name.","example":"The authentication option's name"},"type":{"type":"string","description":"The authentication type. \n * `enforce_login` - Only users logged in to Zoom can view the recordings. \n * `enforce_login_with_domains` - Only users from specific domains can view the recordings. The list of domains is defined in the `domains` field. \n * `internally` - Only the Zoom account's users can view the recordings.","example":"enforce_login","enum":["enforce_login","enforce_login_with_domains","internally"]},"visible":{"type":"boolean","description":"Whether the authentication option is visible.","example":true}}}},"recording_authentication":{"type":"boolean","description":"Whether only authenticated users can view cloud recordings.","example":true}},"description":"The user's recording authentication settings."}}}}},{"type":"object","oneOf":[{"type":"object","properties":{"allow_authentication_exception":{"type":"boolean","description":"Whether the [**Allow authentication exception**](https://support.zoom.us/hc/en-us/articles/360037117472#h_01F13A9N1FQFNVESC9C21NRHXY) setting is enabled. This lets hosts invite users who can bypass authentication.","example":true},"authentication_options":{"type":"array","description":"The meeting authentication options","items":{"type":"object","properties":{"default_option":{"type":"boolean","description":"The authentication default option.","example":true},"domains":{"type":"string","description":"The authentication domains.","example":"example.com"},"id":{"type":"string","description":"The authentication ID.","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"The authentication name.","example":"Authentication name"},"type":{"type":"string","description":" The authentication type. Specify one of the following authentication types for the authentication profile: \n \n * `enforce_login`: This option allows any users to join the meeting or webinar, as long as they are signed into their Zoom account.\n * `enforce_login_with_domains`: This option, allows you to specify a rule so that only those Zoom users whose email addresses contain a certain domain, can join the meeting or webinar. You can either add multiple domains using a comma in between and/or use a wildcard for listing domains. \n \n * `enforce_login_with_same_account`: This option allows users to join the meeting or webinar with the same Zoom account.","example":"enforce_login_with_domains","enum":["enforce_login","enforce_login_with_same_account","enforce_login_with_domains"]},"visible":{"type":"boolean","description":"This setting indicates if the authentication is visible.","example":true}}}},"meeting_authentication":{"type":"boolean","description":"Only authenticated users can join meetings","example":true}}},{"type":"object","properties":{"authentication_options":{"type":"array","description":"The authentication options.","items":{"type":"object","properties":{"default_option":{"type":"boolean","description":"The authentication default option.","example":true},"domains":{"type":"string","description":"The authentication domains.","example":"example.com"},"id":{"type":"string","description":"The authentication ID.","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"The name of the authentication.","example":"Authentication name"},"type":{"type":"string","description":"The type of authentication.","example":"enforce_login_with_domains","enum":["internally","enforce_login","enforce_login_with_domains"]},"visible":{"type":"boolean","description":"The authentication is visible.","example":true}}}},"recording_authentication":{"type":"boolean","description":"Only authenticated users can view cloud recordings","example":true}}}]},{"title":"Meeting/Webinar Security Settings","type":"object","properties":{"meeting_security":{"type":"object","properties":{"auto_security":{"type":"boolean","description":"Whether all meetings must be secured with at least one security option. \n\n This setting can only be disabled by Enterprise, ISV, Business (with more than 100 licenses), and Education accounts.","example":true},"block_user_domain":{"type":"boolean","description":"Whether users in specific domains are blocked from joining meetings and webinars.","example":true},"block_user_domain_list":{"maxItems":20,"type":"array","description":"The blocked domains.","items":{"maxLength":30,"minLength":5,"type":"string","example":"example.com"}},"embed_password_in_join_link":{"type":"boolean","description":"Whether the meeting passcode is encrypted and included in the invitation link. The provided link will allow participants to join the meeting without having to enter the passcode.","example":true},"encryption_type":{"type":"string","description":"The type of encryption used when starting a meeting: \n* `enhanced_encryption` - Enhanced encryption. Encryption data is stored in the cloud. \n* `e2ee` - End-to-end encryption. The encryption key is stored on the local device and cannot be obtained by anyone else. Enabling E2EE also [**disables** certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":"e2ee","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Whether end-to-end encryption is enabled for meetings.","example":true},"meeting_password":{"type":"boolean","description":"Whether all instant and scheduled meetings that users can join via client or Zoom Rooms systems are passcode-protected. [Personal Meeting ID (PMI)](https://support.zoom.us/hc/en-us/articles/203276937) meetings are **not** included in this setting.","example":true},"meeting_password_requirement":{"type":"object","properties":{"consecutive_characters_length":{"type":"integer","description":"The maximum length of consecutive characters (for example, `abcdef`) allowed in a passcode: \n* `4` through `8` - The maximum consecutive characters length. The length is `n` minus `1`, where `n` is the value. For example, if the value is `4`, there can only be a maximum of `3` consecutive characters in a passcode (for example, `abc1x@8fdh`). \n* `0` - No consecutive character restriction.","example":8,"enum":[0,4,5,6,7,8]},"have_letter":{"type":"boolean","description":"Whether passcodes must contain at least one letter character.","example":true},"have_number":{"type":"boolean","description":"Whether passcodes must contain at least one numeric character.","example":true},"have_special_character":{"type":"boolean","description":"Whether passcodes must contain at least one special character. For example, `!`, `@`, and/or `#` characters.","example":true},"have_upper_and_lower_characters":{"type":"boolean","description":"Whether passcodes must include uppercase and lowercase characters.","example":true},"length":{"type":"integer","description":"The minimum passcode length.","example":10},"only_allow_numeric":{"type":"boolean","description":"Whether passcodes must contain **only** numeric characters.","example":true},"weak_enhance_detection":{"type":"boolean","description":"Whether users are informed when the provided passcode is weak.","example":true}},"description":"The information about the meeting and webinar [passcode requirements](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604)."},"only_authenticated_can_join_from_webclient":{"type":"boolean","description":"Whether to specify that only authenticated users can join the meeting from the web client.","example":true},"phone_password":{"type":"boolean","description":"Whether passcodes are required for participants joining by phone. \n\n If enabled and the meeting is passcode-protected, a numeric passcode is required for participants to join by phone. For meetings with alphanumeric passcodes, a numeric passcode will be generated.","example":true},"pmi_password":{"type":"boolean","description":"Whether all Personal Meeting ID (PMI) meetings that users can join via client or Zoom Rooms systems are passcode-protected.","example":true},"require_password_for_scheduled_meeting":{"type":"boolean","description":"Whether passcodes are required for meetings that have already been scheduled.","example":true},"require_password_for_scheduled_webinar":{"type":"boolean","description":"Whether passcodes are required for webinars that have already been scheduled.","example":true},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting. \n\n If the **Waiting Room** feature is enabled, the [**Allow participants to join before host**](https://support.zoom.us/hc/en-us/articles/202828525-Allow-participants-to-join-before-host) setting is automatically disabled.","example":true},"waiting_room_settings":{"type":"object","properties":{"participants_to_place_in_waiting_room":{"type":"integer","description":"The type of participants to be admitted to the Waiting Room: \n* `0` - All attendees. \n* `1` - Users who are not in your account. \n* `2` - Users who are not in your account and are not part of your [allowed domains list](https://support.zoom.us/hc/en-us/articles/360037117472-Configuring-authentication-profiles#h_e3cf0d5f-eec7-4c2a-ad29-ef2a5079a7da).","example":1,"enum":[0,1,2]},"users_who_can_admit_participants_from_waiting_room":{"type":"integer","description":"The users who can admit participants from the Waiting Room: \n* `0` - Host and co-hosts only. \n* `1` - Host, co-hosts, and anyone who bypassed the Waiting Room if the host and co-hosts are not present.","example":1,"enum":[0,1]},"whitelisted_domains_for_waiting_room":{"type":"string","description":"If the `participants_to_place_in_waiting_room` field is `2`, a comma-separated list of the domains that can bypass the Waiting Room (`example.com,example2.com`).","example":"example.com"}},"description":"The information about the Waiting Room settings."},"webinar_password":{"type":"boolean","description":"Whether to generate a passcode when scheduling webinars. Participants must use the generated passcode to join the scheduled webinar.","example":true}}}},"description":"The meeting and webinar security settings."}]}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `1120`
\n A valid invitation to join the Zoom account was not found for this user.
\nThis error is thrown if you added a user in your account but the user did not accept the invitation on time and the invitation expired - thus making the userId invalid.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user:read:settings","user:read:settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin"],"x-granular-scopes":["user:read:settings","user:read:settings:admin"]}},"patch":{"tags":["Users"],"summary":"Update user settings","description":"Update a user's settings. \nFor user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:update:settings`,`user:update:settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"userSettingsUpdate","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}},{"name":"option","in":"query","description":"The optional query parameters: \n* `meeting_authentication` — Use this query parameter to view the [meeting authentication settings](https://support.zoom.us/hc/en-us/articles/360037117472-Authentication-Profiles-for-Meetings-and-Webinars) applied to the user's account. \n* `recording_authentication` — Use this query parameter to view the [recording authentication settings](https://support.zoom.us/hc/en-us/articles/360037756671-Authentication-Profiles-for-Cloud-Recordings) applied to the user's account. \n* `meeting_security` — Use this query parameter to view the meeting security settings applied to the user's account.","required":false,"schema":{"type":"string","example":"meeting_security","enum":["meeting_authentication","recording_authentication","meeting_security"]}}],"requestBody":{"description":"The user's settings.","content":{"application/json":{"schema":{"oneOf":[{"title":"The user's settings.","type":"object","properties":{"audio_conferencing":{"title":"The user's settings: Audio conferencing settings.","type":"object","properties":{"participant_phone_masking":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to mask phone numbers of users dialing into a meeting in the participant list.","example":true},"masking_type":{"type":"string","description":"The type of phone number masking pattern to apply. \n* `mask_default` - Default masking pattern (Example: 888****666). \n* `mask_first_5` - Mask first five digits (Example: *****66666). \n* `mask_except_last_4` - Mask everything except last four digits (Example: *****6666).","example":"mask_default","enum":["mask_default","mask_first_5","mask_except_last_4"],"x-enum-descriptions":["Default masking pattern (Example: 888****666).","Mask first five digits (Example: *****66666).","Mask everything except last four digits (Example: *****6666)."]}},"description":"The user's [**Mask phone number in the participant list**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067881#h_01F5K5HBEEEXRXR9SN5ZBNWN30) settings.","example":true},"global_dial_in_countries":{"type":"object","properties":{"selected_countries":{"type":"array","description":"The list of selected countries/regions whose dial-in numbers will be listed in the email invitation. You can adjust the order that the dial-in numbers appear in the email invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The [code](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}},"include_toll_free":{"type":"boolean","description":"Whether to include toll-free numbers in the email invitation for the selected countries/regions.","example":true}},"description":"The user's [**Global Dial-in Countries/Regions**](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0068094#h_01F5KKA1Y2CWNT35HF5C0JZY89) settings."}},"description":"The user's audio conference settings."},"email_notification":{"title":"The user's settings: Notification settings.","type":"object","properties":{"alternative_host_reminder":{"type":"boolean","description":"When an alternative host is set or removed from a meeting.","example":true,"default":false},"cancel_meeting_reminder":{"type":"boolean","description":"When a meeting is cancelled.","example":true,"default":false},"cloud_recording_available_reminder":{"type":"boolean","description":"Whether to notify the host when a cloud recording is available.","example":true},"jbh_reminder":{"type":"boolean","description":"When attendees join meeting before host.","example":true,"default":false},"recording_available_reminder_alternative_hosts":{"type":"boolean","description":"Whether to notify any alternative hosts when a cloud recording is available.","example":true},"recording_available_reminder_schedulers":{"type":"boolean","description":"Whether to notify the person who scheduled the meeting or webinar for the host when a cloud recording is available.","example":true},"schedule_for_reminder":{"type":"boolean","description":"This setting notifies the host there is a meeting is scheduled, rescheduled, or cancelled.","example":true,"default":false}}},"feature":{"title":"The user's settings: Feature settings.","type":"object","properties":{"concurrent_meeting":{"type":"string","description":"The user's assigned [Concurrent Meeting](https://support.zoom.us/hc/en-us/articles/206122046) type: \n* `Basic` \n* `Plus` \n* `None` \n\n **Note:** This feature requires a Concurrent Meeting Basic or Plus plan subscription.","example":"Plus","enum":["Basic","Plus","None"],"x-enum-descriptions":["Concurrent Meeting Basic","Concurrent Meeting Plus","Concurrent Meeting disabled"]},"large_meeting":{"type":"boolean","description":"This setting enables the [large meeting](https://support.zoom.us/hc/en-us/articles/201362823-What-is-a-Large-Meeting-) feature for the user.","example":true},"large_meeting_capacity":{"type":"integer","description":"This field sets the meeting capacity for the user if the user has the **Large meeting** feature enabled. The value for the field can be 500, 1000, 3000, or 5000.","example":500},"meeting_capacity":{"type":"integer","description":"This field sets a user's meeting capacity. The user's meeting capacity denotes the maximum number of participants that can join a meeting scheduled by the user.","example":100},"webinar":{"type":"boolean","description":"This setting enables Webinar feature for the user.","example":true},"webinar_capacity":{"type":"integer","description":"The user's webinar capacity. This only applies to users with the [**Webinar**](https://support.zoom.us/hc/en-us/articles/200917029-Getting-started-with-webinar) feature enabled: \n* `100` \n* `500` \n* `501` \n* `1000` \n* `1001` \n* `3000` \n* `5000` \n* `10000`","example":100,"enum":[100,500,501,1000,1001,3000,5000,10000]},"zoom_events":{"type":"boolean","description":"Whether to enable the Zoom Events feature for the user.","example":true},"zoom_events_capacity":{"type":"integer","description":"The user's Zoom Events plan capacity: `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`.","example":500,"enum":[500,1000,3000,5000,10000,20000,30000,50000]},"zoom_events_unlimited":{"type":"boolean","description":"Whether to enable the Zoom Events Unlimited feature for the user.","example":true},"zoom_events_unlimited_capacities":{"maxItems":9,"type":"array","description":"The capacity list of user's Zoom Events Unlimited plan: `100`, `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`.","example":[100,500],"items":{"type":"integer","example":500,"enum":[100,500,1000,3000,5000,10000,20000,30000,50000]}},"zoom_sessions_unlimited":{"type":"boolean","description":"Whether to enable the Zoom Sessions Unlimited feature for the user.","example":true,"deprecated":true},"zoom_sessions_unlimited_capacities":{"maxItems":9,"type":"array","description":"The capacity list of user's Zoom Sessions Unlimited plan: `100`, `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`.","example":[100,500],"deprecated":true,"items":{"type":"integer","example":500,"enum":[100,500,1000,3000,5000,10000,20000,30000,50000]}},"zoom_webinars_plus_unlimited":{"type":"boolean","description":"Whether to enable the Zoom Webinars Plus Unlimited feature for the user.","example":true},"zoom_webinars_plus_unlimited_capacities":{"maxItems":9,"type":"array","description":"The capacity list of user's Zoom Webinars Plus Unlimited plan - `100`, `500`, `1000`, `3000`, `5000`, `10000`, `20000`, `30000`, or `50000`.","example":[100,500],"items":{"type":"integer","example":500,"enum":[100,500,1000,3000,5000,10000,20000,30000,50000]}},"zoom_events_pay_per_attendee":{"type":"boolean","description":"Whether to enable the Zoom Events Pay Per Attendee feature for the user.","example":true},"zoom_sessions_pay_per_attendee":{"type":"boolean","description":"Whether to enable the Zoom Sessions Pay Per Attendee feature for the user.","example":true},"zoom_phone":{"type":"boolean","description":"The Zoom phone feature. If the value is set to false, will remove user from Zoom Phone. All numbers and phones assigned to the users will become unassigned. ","example":true},"zoom_iq_for_sales":{"type":"boolean","description":"Whether the user has a Zoom Revenue Accelerator license. For information about a Zoom Revenue Accelerator license, contact [Zoom Support](https://support.zoom.us/hc/en-us/articles/201362003).","example":false,"deprecated":true},"zoom_revenue_accelerator":{"type":"boolean","description":"Whether the user has a Zoom Revenue Accelerator license. For information about a Zoom Revenue Accelerator license, contact [Zoom Support](https://support.zoom.us/hc/en-us/articles/201362003).","example":false},"zoom_whiteboard":{"type":"boolean","description":"Whether the user has a Zoom Whiteboard license.","example":false},"zoom_whiteboard_plus":{"type":"boolean","description":"Whether the user has a Zoom Whiteboard Plus license.","example":false},"zoom_translated_captions":{"type":"boolean","description":"Whether the user has a Zoom Translated Captions license.","example":false},"zoom_customer_managed_key":{"type":"boolean","description":"Whether the user has a Zoom Customer Managed Key license.","example":false},"zoom_huddles":{"type":"boolean","description":"Whether the user has a Zoom Huddles license.","example":false,"deprecated":true},"zoom_quality_management":{"type":"boolean","description":"Whether the user has a Zoom Quality Management license.","example":false},"zoom_workforce_management":{"type":"boolean","description":"Whether the user has a Zoom Workforce Management license.","example":false},"zoom_scheduler":{"type":"boolean","description":"Whether the user has a Zoom Scheduler license.","example":false},"zoom_clips_plus":{"type":"boolean","description":"Whether the user has a Zoom Clips Plus license.","example":false},"zoom_mail_calendar":{"type":"boolean","description":"Whether the user has a Zoom Mail Calendar license.","example":false},"zoom_compliance_management":{"type":"boolean","description":"Whether the user has a Zoom Compliance Management license.","example":false},"zoom_docs":{"type":"boolean","description":"Whether the user has a Zoom Docs license.","example":false,"deprecated":true},"zoom_canvas":{"type":"boolean","description":"Whether the user has a Zoom Canvas license.","example":false},"license_info_list":{"maxItems":99,"type":"array","description":"A list of license information used to specify the appropriate license type, license option, and license subscription reference ID.","items":{"required":["license_option","license_type"],"type":"object","properties":{"license_type":{"type":"string","description":"The corresponding type for the license that needs to be updated.","example":"ZOOM_WHITEBOARD","enum":["ZOOM_WHITEBOARD","ZOOM_TRANSLATED_CAPTIONS","ZOOM_SCHEDULER","ZOOM_CLIPS","ZOOM_VISITOR_MANAGEMENT","ZOOM_CMK","ZOOM_DOCS","ZOOM_REVENUE_ACCELERATOR","ZOOM_COMPLIANCE_MANAGEMENT","ZOOM_WORKFORCE_MANAGEMENT","ZOOM_QUALITY_MANAGEMENT","ZOOM_HEALTHCARE_CLINICAL_NOTES","ZOOM_EVENTS_NEW_SAAS","ZOOM_EVENTS_CONSUMPTION","ZOOM_WEBINARS_PLUS","ZOOM_WEBINARS_PLUS_CONSUMPTION","ZOOM_CUSTOM_AI_COMPANION","CX_INSIGHTS","ZOOM_ENHANCED_MEDIA","EDU_STUDENT"]},"license_option":{"type":"integer","description":"License option\nFor the parameters with **licenseType** as **ZOOM_WHITEBOARD:**\n `2` - Zoom Whiteboard.\n `65536` - Zoom Whiteboard Plus.\n\nFor the parameters with **licenseType** as **ZOOM_TRANSLATED_CAPTIONS**:\n `2048` - Zoom Translated Captions.\n \nFor the parameters with **licenseType** as **ZOOM_SCHEDULER**:\n `2199023255552` - Zoom Scheduler.\n\nFor the parameters with **licenseType** as **ZOOM_CLIPS**:\n `1` - Zoom Clips Plus.\n\nFor the parameters with **licenseType** as **ZOOM_VISITOR_MANAGEMENT**:\n `2147483648` - Zoom Visitor Management.\n\nFor the parameters with **licenseType** as **ZOOM_CMK**:\n `131072` - Zoom Customer Managed Key.\n\nFor the parameters with **licenseType** as **ZOOM_DOCS**:\n `281474976710656` - Zoom Docs.\n\n\nFor the parameters with **licenseType** as **ZOOM_CANVAS**:\n `281474976710656` - Zoom Canvas.\n\nFor the parameters with **licenseType** as **ZOOM_REVENUE_ACCELERATOR**:\n `1` - Zoom Revenue Accelerator.\n\nFor the parameters with **licenseType** as **ZOOM_COMPLIANCE_MANAGEMENT**:\n `8796093022208` - Zoom Compliance Management.\n `17592186044416` - Zoom Compliance Management Plus.\n\nFor the parameters with **licenseType** as **ZOOM_WORKFORCE_MANAGEMENT**:\n `549755813888` - Zoom Workforce Management.\n\nFor the parameters with **licenseType** as **ZOOM_QUALITY_MANAGEMENT**:\n `1099511627776` - Zoom Quality Management.\n `35184372088832` - Zoom Advanced Quality Management.\n\nFor the parameters with **licenseType** as **ZOOM_HEALTHCARE_CLINICAL_NOTES**:\n `512` - Zoom Workplace for Clinicians Unlimited.\n `4503599627370496` - Zoom Workplace for Clinicians - Pay Per Notes.\n\nFor the parameters with **licenseType** as **ZOOM_EVENTS_NEW_SAAS**:\n `2` - Zoom Events Unlimited - 100 attendees.\n `4` - Zoom Events Unlimited - 500 attendees.\n `8` - Zoom Events Unlimited - 1000 attendees.\n `16` - Zoom Events Unlimited - 3000 attendees.\n `32` - Zoom Events Unlimited - 5000 attendees.\n `64` - Zoom Events Unlimited - 10000 attendees.\n `128` - Zoom Events Unlimited - 20000 attendees.\n `256` - Zoom Events Unlimited - 30000 attendees.\n `512` - Zoom Events Unlimited - 50000 attendees.\n\nFor the parameters with **licenseType** as **ZOOM_EVENTS_CONSUMPTION**:\n `1` - Zoom Events - Pay Per Attendee.\n\nFor the parameters with **licenseType** as **ZOOM_WEBINARS_PLUS**:\n `2048` - Zoom Webinars Plus Unlimited - 100 attendees.\n `4096` - Zoom Webinars Plus Unlimited - 500 attendees.\n `8192` - Zoom Webinars Plus Unlimited - 1000 attendees.\n `16384` - Zoom Webinars Plus Unlimited - 3000 attendees.\n `32768` - Zoom Webinars Plus Unlimited - 5000 attendees.\n `65536` - Zoom Webinars Plus Unlimited - 10000 attendees.\n `131072` - Zoom Webinars Plus Unlimited - 20000 attendees.\n `262144` - Zoom Webinars Plus Unlimited - 30000 attendees.\n `524288` - Zoom Webinars Plus Unlimited - 50000 attendees.\n\nFor the parameters with **licenseType** as **ZOOM_WEBINARS_PLUS_CONSUMPTION**:\n `1024` - Zoom Webinars Plus - Pay Per Attendee.\n\nFor the parameters with **licenseType** as **ZOOM_CUSTOM_AI_COMPANION**:\n `256` - Zoom Custom AI Companion.\n `4096` - Zoom AI Companion.\n\nFor the parameters with **licenseType** as **CX_INSIGHTS_LEADER**:\n `1099511627776` - CX Insights Leader.\n\nFor the parameters with **licenseType** as **ZOOM_ENHANCED_MEDIA**:\n `4503599627370496` - Zoom Enhanced Media.\n\nFor the parameters with **licenseType** as **EDU_STANDARD_STUDENT**:\n `1152921504606846976` - Education Standard Student.","format":"int64","example":2,"enum":[1,2,4,8,16,32,64,128,256,512,1024,2048,4096,8192,16384,32768,65536,131072,262144,524288,2147483648,549755813888,1099511627776,2199023255552,8796093022208,17592186044416,35184372088832,281474976710656,4503599627370496]},"subscription_id":{"type":"string","description":"The subscription ID associated with the corresponding license.","example":"SUBREF-xxxxxx-xxxxxx"}}}}}},"in_meeting":{"title":"User In Meeting Settings","type":"object","properties":{"allow_host_to_enable_focus_mode":{"type":"boolean","description":"Whether the host can enable the [**Focus Mode**](https://support.zoom.us/hc/en-us/articles/360061113751-Using-focus-mode) when scheduling a meeting. This value defaults to `null`.","example":true},"allow_users_to_delete_messages_in_meeting_chat":{"type":"boolean","description":"If the value of this field is set to `true`, it allows users to delete messages in the in-meeting chat.\n","example":true},"allow_live_streaming":{"type":"boolean","description":"Allow livestreaming.","example":true},"post_meeting_feedback":{"type":"boolean","description":"Whether to display a thumbs up or thumbs down feedback survey at the end of each meeting.","example":true},"whiteboard":{"type":"boolean","description":"Whether to enable the [**Zoom Whiteboard**](https://support.zoom.us/hc/en-us/articles/4410916881421) feature.","example":true},"allow_participants_chat_with":{"type":"integer","description":"Who participants can chat with: \n* `1` — The participant cannot use chat. \n* `2` — The participant can chat with the host and co-hosts only. \n * `3` — The participant can chat with other participants publicly. \n* `4` - The participant can chat with other participants publicly and privately. \n\n **Note:** This setting is only available with client versions 5.7.3 and above.","example":4,"enum":[1,2,3,4]},"allow_users_save_chats":{"type":"integer","description":"How participants can save meeting chats: \n* `1` — Participants cannot save meeting chats. \n* `2` — Participants can only save host and co-host meeting chats. \n* `3` — Participants can save all meeting chats.","example":3,"enum":[1,2,3]},"annotation":{"type":"boolean","description":"This setting allows meeting participants to use the [annotation tools](https://support.zoom.us/hc/en-us/articles/115005706806). This value defaults to `false`.","example":true,"default":false},"attendee_on_hold":{"type":"boolean","description":"This setting allows the host to put an attendee on hold. This value defaults to `false`. **This field has been deprecated and is no longer supported.**","example":true,"default":false},"attention_mode_focus_mode":{"type":"boolean","description":"Whether the [**Focus Mode**](https://support.zoom.us/hc/en-us/articles/360061113751-Using-focus-mode) feature is enabled. When enabled, this feature only displays the host and co-hosts' video and profile pictures during a meeting. \n\n This value defaults to `false`.","example":true,"default":false},"auto_saving_chat":{"type":"boolean","description":"This setting automatically saves all in-meeting chats. This value defaults to `false`.","example":true,"default":false},"breakout_room":{"type":"boolean","description":"This setting allows the meeting host to split meeting participants into separate breakout rooms.","example":true,"default":false},"breakout_room_schedule":{"type":"boolean","description":"This setting allows the host to assign participants to breakout rooms when scheduling. This feature is **only** available in version 4.5.0 or higher.","example":true},"chat":{"type":"boolean","description":"This setting enables chat during meeting for all participants. This value defaults to `false`.","example":true,"default":false},"meeting_question_answer":{"type":"boolean","description":"This setting allows participants to ask questions for the host and participants to answer.","example":true},"closed_caption":{"type":"boolean","description":"This setting enables closed captions. This value defaults to `false`.","example":true,"default":false},"closed_captioning":{"type":"object","properties":{"auto_transcribing":{"type":"boolean","description":"This setting allows a live transcription service to transcribe meetings.","example":true},"enable":{"type":"boolean","description":"This setting allows the host to type closed captions or assign a participant or 3rd-party service to provide closed captioning.","example":true},"save_caption":{"type":"boolean","description":"This setting allows participants to save closed captions or transcripts.","example":true},"third_party_captioning_service":{"type":"boolean","description":"This setting allows the use of an API token to integrate with third-party closed captioning services.","example":true},"view_full_transcript":{"type":"boolean","description":"This setting allows the viewing of full transcripts in the in-meeting side panel.","example":true}},"description":"The information about the user's closed captioning settings."},"co_host":{"type":"boolean","description":"This setting allows the host to add co-hosts. This value defaults to `false`.","example":true,"default":false},"custom_data_center_regions":{"type":"boolean","description":"This setting uses custom [data center regions](https://support.zoom.us/hc/en-us/articles/360042411451-Selecting-data-center-regions-for-meetings-webinars): \n* `true` — Users can [select data center regions](https://support.zoom.us/hc/en-us/articles/360042411451-Selecting-data-center-regions-for-hosted-meetings-and-webinars) to use for hosting real-time meeting traffic. The data center regions can be provided in the `data_center_regions` field. \n* `false` — Only use the default data center regions.","example":true},"custom_live_streaming_service":{"type":"boolean","description":"This setting allows custom livestreaming.","example":true},"custom_service_instructions":{"type":"string","description":"The custom livestreaming service instructions.","example":"The custom livestreaming service instructions"},"data_center_regions":{"type":"array","description":"If the value of `custom_data_center_regions` is `true`, a comma-separated list of the following [data center regions](https://support.zoom.us/hc/en-us/articles/360059254691-Datacenter-abbreviation-list) to opt in to: \n* `AU` — Australia.\n* `LA` — Latin America. \n* `CA` — Canada. \n* `CN` — China. \n* `DE` — Germany. \n* `HK` — Hong Kong SAR. \n* `IN` — India. \n* `IE` — Ireland. \n* `TY` — Japan. \n* `MX` — Mexico. \n* `NL` — Netherlands. \n* `SG` — Singapore. \n* `US` — United States.","items":{"type":"string","example":"US","enum":["AU","LA","CA","CN","DE","HK","IN","IE","TY","MX","NL","SG","US"]}},"disable_screen_sharing_for_host_meetings":{"type":"boolean","description":"This setting enables the **Disable desktop screen sharing for meetings you host** setting.","example":true},"disable_screen_sharing_for_in_meeting_guests":{"type":"boolean","description":"This setting enables the **Disable screen sharing when guests are in the meeting** setting.","example":true},"e2e_encryption":{"type":"boolean","description":"This setting requires [AES encryption](https://en.wikipedia.org/wiki/Advanced_Encryption_Standard) for meetings.","example":true},"entry_exit_chime":{"type":"string","description":"When to play the meeting entry/exit sound notification: \n* `host` — Only when the host joins or leaves. \n* `all` — When any participant joins or leaves. \n* `none` - Disable the entry/exit sound notification. \n\nThis value defaults to `all`.","example":"all","default":"all","enum":["host","all","none"]},"far_end_camera_control":{"type":"boolean","description":"This setting allows another user to take control of the user's camera. This value defaults to `false`.","example":true,"default":false},"feedback":{"type":"boolean","description":"This field enables the [**Feedback to Zoom**](https://support.zoom.us/hc/en-us/articles/115005838023-Feedback-to-Zoom) setting. This value defaults to `false`.","example":true,"default":false},"file_transfer":{"type":"boolean","description":"This setting indicates whether [in-meeting file transfer](https://support.zoom.us/hc/en-us/articles/209605493-In-meeting-file-transfer) setting has been enabled for the user or not.","example":true},"group_hd":{"type":"boolean","description":"This setting enables the group HD video in Meeting. This value defaults to `false`.","example":true,"default":false},"webinar_group_hd":{"type":"boolean","description":"This setting enables the group HD video in Webinar. This value defaults to `false`.","example":true,"default":false},"join_from_desktop":{"type":"boolean","description":"This setting allows participants to join a meeting directly from their desktop browser. Note that the meeting experience from the desktop browser is limited.","example":true},"join_from_mobile":{"type":"boolean","description":"This setting allows participants to join a meeting directly from their mobile browser. Note that the meeting experience from the mobile browser is limited.","example":true},"language_interpretation":{"type":"object","properties":{"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"English"}},"enable_language_interpretation_by_default":{"type":"boolean","description":"Whether enable language interpretation by default.","example":true},"allow_participants_to_speak_in_listening_channel":{"type":"boolean","description":"Whether to allow participants to speak in listening channel.","example":true},"allow_up_to_25_custom_languages_when_scheduling_meetings":{"type":"boolean","description":"Whether to allow up to 25 custom languages when scheduling meetings.","example":true},"enable":{"type":"boolean","description":"This setting allows the hosts to assign participants as interpreters who can interpret one language into another in real-time.","example":true}},"description":"The information about the [language interpretation](https://support.zoom.us/hc/en-us/articles/360034919791-Using-Language-Interpretation-in-your-meeting-or-webinar) settings."},"sign_language_interpretation":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to allow hosts to assign participants as sign language interpreters who can interpret one language into another in real-time.","example":true},"enable_sign_language_interpretation_by_default":{"type":"boolean","description":"Whether to enable sign language interpretation view by default in scheduler.","example":true},"languages":{"type":"array","description":"A list of system-supported languages.","items":{"type":"string","example":"American","enum":["American","Chinese","French","German","Japanese","Russian","Brazilian","Spanish","Mexican","British"]}},"custom_languages":{"type":"array","description":"A list of user-defined supported languages.","items":{"type":"string","example":"Language1"}}},"description":" This setting allows hosts to assign participants as sign language interpreters who can interpret one language into sign language in real-time. Hosts can assign interpreters when scheduling, or during the meeting itself. This feature is only available with version 5.11.3 or later."},"live_streaming_facebook":{"type":"boolean","description":"This setting allows Facebook livestreaming.","example":true},"live_streaming_youtube":{"type":"boolean","description":"This setting allows YouTube to livestreaming.","example":true},"manual_captioning":{"type":"object","properties":{"allow_to_type":{"type":"boolean","description":"This setting allows the host to manually caption or let the host assign a participant to provide manual captioning.","example":true},"auto_generated_captions":{"type":"boolean","description":"This setting enables Zoom's [live transcription feature](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription#h_01FHGGHYJ4457H4GSZY0KM3NSB).","example":true},"full_transcript":{"type":"boolean","description":"This setting enables the viewing of full transcripts in the in-meeting side panel.","example":true},"manual_captions":{"type":"boolean","description":"The [Enable manual closed captioning](https://support.zoom.us/hc/en-us/articles/207279736-Managing-closed-captioning-and-live-transcription) setting.","example":true},"save_captions":{"type":"boolean","description":"This setting allows participants to [save closed captions or transcripts](https://support.zoom.us/hc/en-us/articles/360060958752). \n\n **Note:** If the `full_transcript` field is set to `false`, participants **cannot** save captions.","example":true},"third_party_captioning_service":{"type":"boolean","description":"This setting allows the use of an API token to integrate with a [third-party device](https://support.zoom.us/hc/en-us/articles/115002212983) to provide closed captioning.","example":true}},"description":"The information about manual captioning settings."},"meeting_reactions":{"type":"boolean","description":"Whether meeting participants can [communicate using the emoji reactions](https://support.zoom.us/hc/en-us/articles/115001286183-Nonverbal-feedback-and-meeting-reactions) located in the **Reactions** menu in the meeting toolbar.","example":true},"meeting_reactions_emojis":{"type":"string","description":"Users can choose from the following meeting reaction options:\n* `all` — All emojis: Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.\n* `selected` — Selected emojis: Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration) ","example":"all","enum":["all","selected"],"x-enum-descriptions":["Allow meeting participants to use any emoji available in Zoom chat as a reaction in a meeting.","Allow meeting participants to use the 6 standard meeting reaction emojis: Clapping Hands, Thumbs Up, Heart, Tears of Joy, Open Mouth, Party Popper (Tada, Celebration) ."]},"allow_host_panelists_to_use_audible_clap":{"type":"boolean","description":"Whether to allow host and panelist to use audible clap.","example":true},"webinar_reactions":{"type":"boolean","description":"Setting this field to true allow you to use [webinar reactions](https://support.zoom.us/hc/en-us/articles/4803536268429).","example":true},"meeting_survey":{"type":"boolean","description":"This setting allows the host to present a survey to participants once a meeting has ended. This feature is only available in version 5.7.3 or higher.","example":true},"non_verbal_feedback":{"type":"boolean","description":"This setting enables the [**Non-verbal feedback**](https://support.zoom.us/hc/en-us/articles/115001286183-Nonverbal-feedback-and-meeting-reactions-) feature. This value defaults to `false`.","example":true,"default":false},"polling":{"type":"boolean","description":"This setting adds polls to the meeting controls. This value defaults to `false`.","example":true,"default":false},"private_chat":{"type":"boolean","description":"This setting [enables private chat](https://support.zoom.us/hc/en-us/articles/360060835932-Enabling-and-disabling-private-chat) between participants during meetings. This value defaults to `false`.","example":true,"default":false},"record_play_voice":{"type":"boolean","description":"This setting allows users to record and play their own voice.","example":true},"remote_control":{"type":"boolean","description":"This setting enables the [**Remote control**](https://support.zoom.us/hc/en-us/articles/201362673-Requesting-or-giving-remote-control) feature. This value defaults to `false`.","example":true,"default":false},"remote_support":{"type":"boolean","description":"This setting enables the [**Remote support**](https://support.zoom.us/hc/en-us/articles/360060951012-Enabling-remote-support) feature. This value defaults to `false`.","example":true,"default":false},"request_permission_to_unmute_participants":{"type":"boolean","description":"This setting indicates whether the [**Request permission to unmute participants**](https://support.zoom.us/hc/en-us/articles/203435537-Muting-and-unmuting-participants-in-a-meeting#h_01EGK4XFWS1SJGZ71MYGKF7260) option has been enabled for the user or not.","example":true},"screen_sharing":{"type":"boolean","description":"This setting allows host and participants to share their screen or content during meetings\n","example":true},"share_dual_camera":{"type":"boolean","description":"This setting allows the use of shared dual cameras. This value defaults to `false`. **This field is deprecated.**","example":true,"deprecated":true,"default":false},"show_a_join_from_your_browser_link":{"type":"boolean","description":"This setting allows participants to join a meeting directly from their browser and bypass the Zoom application download process. This is useful for participants who cannot download, install, or run applications. Note that the meeting experience from the browser is limited.","example":true},"show_meeting_control_toolbar":{"type":"boolean","description":"This setting allows you to always display [in-meeting controls](https://support.zoom.us/hc/en-us/articles/360021921032-Zoom-Room-meeting-controls-and-settings#h_01EQCC03TCPRC72VKXZ7W47FDX).","example":true},"slide_control":{"type":"boolean","description":"Whether the person sharing during a presentation can allow others to control the slide presentation. This feature is only available in version 5.8.3 or higher.","example":true},"virtual_background":{"type":"boolean","description":"This setting enables virtual backgrounds. This value defaults to `false`.","example":true,"default":false},"virtual_background_settings":{"type":"object","properties":{"allow_upload_custom":{"type":"boolean","description":"This setting allows the user to upload custom virtual backgrounds.","example":true},"allow_videos":{"type":"boolean","description":"This setting allows the use of videos for virtual backgrounds.","example":true},"enable":{"type":"boolean","description":"This setting enables virtual backgrounds.","example":true},"files":{"type":"array","description":"The information about the virtual background files.","items":{"type":"object","properties":{"id":{"type":"string","description":"The virtual background file's ID.","example":"efwwf-f320fg34dsv34-5"},"is_default":{"type":"boolean","description":"Whether the file is the default Virtual Background file.","example":true},"name":{"type":"string","description":"The virtual background file's name.","example":"test.png"},"size":{"type":"integer","description":"The virtual background file's size, in bytes.","example":1432},"type":{"type":"string","description":"The virtual background file's type.","example":"image"}}}}},"description":"The user's virtual background settings."},"waiting_room":{"type":"boolean","description":"This setting enables the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) feature. This value defaults to `false`.","example":true,"default":false},"webinar_chat":{"type":"object","properties":{"allow_attendees_chat_with":{"type":"integer","description":"This setting allows webinar attendees to chat with:\n* `1` — No one.\n* `2` — Host and all panelists.\n* `3` — Everyone.","example":1,"enum":[1,2,3]},"allow_auto_save_local_chat_file":{"type":"boolean","description":"This setting automatically saves chat messages to a local file on the host's computer when the webinar ends.","example":true},"allow_panelists_chat_with":{"type":"integer","description":"This setting indicates who the webinar panelists can chat with:\n* `1` — Host and all panelists.\n* `2` — Everyone.","example":2,"enum":[1,2]},"allow_panelists_send_direct_message":{"type":"boolean","description":"This setting allows webinar panelists to send direct messages to other panelists.","example":true},"allow_users_save_chats":{"type":"integer","description":"This setting indicates how the webinar attendees can save chats:\n* `0` — Attendees cannot save chats.\n* `1` — Attendees can only save host and panelist chats.\n* `2` — Attendees can save all chats.","example":1,"enum":[0,1,2]},"default_attendees_chat_with":{"type":"integer","description":"By default, allow webinar attendees to chat with:\n* `1` — Host and all panelists.\n* `2` — Everyone.","example":2,"enum":[1,2]},"enable":{"type":"boolean","description":"This setting allows the webinar participants to send chat messages.","example":true}},"description":"The information about the user's webinar chat settings."},"webinar_live_streaming":{"type":"object","properties":{"custom_service_instructions":{"type":"string","description":"The specific instructions to allow your account's meeting hosts to configure a custom livestream.","example":"The specific instructions"},"enable":{"type":"boolean","description":"Whether webinar livestreaming is enabled.","example":true},"live_streaming_reminder":{"type":"boolean","description":"This setting notifies users to watch the livestream. This does not apply to custom RTMP (real-time messaging protocol).","example":true},"live_streaming_service":{"type":"array","description":"The available livestreaming services:\n* `facebook`\n* `workplace_by_facebook`\n* `youtube`\n* `custom_live_streaming_service`","items":{"type":"string","example":"facebook","enum":["facebook","workplace_by_facebook","youtube","custom_live_streaming_service"],"x-enum-descriptions":["Facebook","Workplace by Facebook","YouTube","Custom Live Streaming Service"]}}}},"meeting_polling":{"type":"object","properties":{"advanced_polls":{"type":"boolean","description":"Whether to allow the host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. The host can also set the correct answers for quizzes they create.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow host to upload an image for each question.","example":true},"enable":{"type":"boolean","description":"Whether to allow the host to add polls before or during a meeting.","example":true}},"description":"The information about the account's meeting polling settings."},"webinar_polling":{"type":"object","properties":{"advanced_polls":{"type":"boolean","description":"Whether to allow the host to create advanced polls and quizzes. Advanced polls and quizzes include single choice, multiple choice, drop down, matching, short answer, long answer, rank order, and fill-in-the-blank questions. The host can also set the correct answers for quizzes they create.","example":true},"allow_alternative_host_to_add_edit":{"type":"boolean","description":"Whether to allow alternative hosts to add or edit polls and quizzes.","example":true},"require_answers_to_be_anonymous":{"type":"boolean","description":"Whether to require answers to be anonymous.","example":true},"allow_host_to_upload_image":{"type":"boolean","description":"Whether to allow host to upload an image for each question.","example":true},"enable":{"type":"boolean","description":"This setting allows the host to add polls before or during a webinar.","example":true}},"description":"The information about the user's webinar polling settings."},"webinar_survey":{"type":"boolean","description":"This setting allows the host to present surveys to attendees once a webinar has ended.","example":true},"who_can_share_screen":{"type":"string","description":"This setting indicates who can share their screen or content during meetings. The value can be one of the following: \n \n`host`: Only host can share the screen. \n \n`all`: Both hosts and attendees can share their screen during meetings. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"all","enum":["host","all"]},"who_can_share_screen_when_someone_is_sharing":{"type":"string","description":"This setting indicates who is allowed to start sharing screen when someone else in the meeting is sharing their screen. The value can be one of the following: \n \n`host`: Only a host can share the screen when someone else is sharing. \n \n`all`: Anyone in the meeting is allowed to start sharing their screen when someone else is sharing. For Webinar, the hosts and panelists can start screen sharing, but not the attendees.\n","example":"all","enum":["host","all"]},"participants_share_simultaneously":{"type":"string","description":"This setting indicates how many participants can share at the same time. The value can be one of the following: \n \n`one`: Only one participant can share at a time\n. \n \n`multiple`: Multiple participants can share simultaneously (dual monitors recommended).","example":"multiple","enum":["multiple","one"]},"workplace_by_facebook":{"type":"boolean","description":"This setting allows Workplace by Facebook livestreaming.","example":true},"auto_answer":{"type":"boolean","description":"This setting allows the user to view and add contacts to the [**Auto-answer group in chat**](https://support.zoom.us/hc/en-us/articles/203736135-Auto-answering-invitations-to-meetings) feature. Calls from members of the **Auto Answer Group** will be automatically answered the user.","example":false},"allow_show_zoom_windows":{"type":"boolean","description":"This setting enables the [**Show Zoom windows during screen share**](https://support.zoom.us/hc/en-us/articles/360061383571-Showing-Zoom-windows-during-screen-share) feature.","example":false}}},"profile":{"title":"Profile","type":"object","properties":{"recording_storage_location":{"type":"object","properties":{"allowed_values":{"type":"array","description":"Users can choose the country to store their recorded content. Content can include meeting, webinar, and phone recordings, as well as voicemail, transcripts, and custom greeting prompts. See [Managing the Communications Content storage location](https://support.zoom.us/hc/en-us/articles/360050781131) for details.\n\nProvide abbreviated country codes as the value for this field. See the [Countries abbreviation list](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#countries) for details.","items":{"type":"string","example":"US"}},"value":{"type":"string","description":"The abbreviated country code.","example":"US"}}}}},"recording":{"title":"User settings: Recording settings","type":"object","properties":{"ask_host_to_confirm_disclaimer":{"type":"boolean","description":"This setting asks the host to confirm the disclaimer.","example":true},"ask_participants_to_consent_disclaimer":{"type":"boolean","description":"This field can be used if `recording_disclaimer` is set to true. This field indicates whether or not you would like to ask participants for consent when a recording starts. The value can be one of the following: \n \n* `true`: Ask participants for consent when a recording starts. \n \n* `false`: Do not ask participants for consent when a recording starts.","example":true},"auto_delete_cmr":{"type":"boolean","description":"The auto delete cloud recordings setting.","example":true,"default":false},"auto_delete_cmr_days":{"type":"integer","description":"When the `auto_delete_cmr` value is `true`, this value is the number of days before the auto-deletion of cloud recordings: \n* `30` — 30 days. \n* `60` — 60 days. \n* `90` — 90 days. \n* `120` — 120 days.","example":90,"enum":[30,60,90,120],"x-enum-descriptions":["30 days.","60 days.","90 days.","120 days."]},"record_files_separately":{"type":"object","properties":{"active_speaker":{"type":"boolean","description":"The record the active speaker only setting.","example":true},"gallery_view":{"type":"boolean","description":"The record the gallery view only setting.","example":true},"shared_screen":{"type":"boolean","description":"The record the shared screen only setting.","example":true}},"description":"The account's [**Record active speaker, gallery view and shared screen separately**](https://support.zoom.us/hc/en-us/articles/360060316092-Changing-basic-and-advanced-cloud-recording-settings#h_01F4CYJTCTXNS2MXH00W9EFG6R) settings."},"display_participant_name":{"type":"boolean","description":"This setting allows you to display the participants' names in the recording.","example":true},"recording_thumbnails":{"type":"boolean","description":"This setting records the thumbnails of the presenter when they are sharing their screen.","example":true},"optimize_recording_for_3rd_party_video_editor":{"type":"boolean","description":"This setting optimizes recordings for a third-party video editor. This may increase the file size and the time it takes to generate recording files.","example":true},"recording_highlight":{"type":"boolean","description":"This setting enables the [recording highlights](https://support.zoom.us/hc/en-us/articles/360060802432) feature.","example":true,"deprecated":true},"save_panelist_chat":{"type":"boolean","description":"This setting saves the panelist chat to the recording. This setting saves messages sent by panelists during a webinar to either all panelists or all panelists and attendees to the recording.","example":true},"save_poll_results":{"type":"boolean","description":"This setting saves the poll results shared during the meeting or webinar. This also includes poll results shared during the meeting or webinar.","example":true},"save_close_caption":{"type":"boolean","description":"This setting saves [closed captions](https://support.zoom.us/hc/en-us/articles/207279736) as a VTT (Video Track Text) file.","example":true},"auto_recording":{"type":"string","description":"The automatic recording: \n `local` - Record on local. \n `cloud` - Record on cloud. \n `none` - Disabled.","example":"cloud","default":"local","enum":["local","cloud","none"],"x-enum-descriptions":["Record on local","Record on cloud","Disabled"]},"cloud_recording":{"type":"boolean","description":"The cloud recording.","example":true,"default":false},"host_pause_stop_recording":{"type":"boolean","description":"The host can pause or stop the auto recording in the cloud.","example":true,"default":false},"ip_address_access_control":{"type":"object","properties":{"enable":{"type":"boolean","description":"If set to `true`, the cloud recordings of this account can only be accessed by the IP addresses defined in the `ip_addresses_or_ranges` property.\n\n","example":true},"ip_addresses_or_ranges":{"type":"string","description":"The IP addresses or ranges that have access to the cloud recordings. Separate multiple IP ranges with comma. Use n.n.n.n, n.n.n.n/n or n.n.n.n - n.n.n.n syntax where n is a number.\n\nExample: `46.33.24.184, 48.99.100.2/25` or `200.181.108.17 - 220.181.108.157`\n\n","example":"46.33.24.184"}},"description":"The setting to allow cloud recording access only from specific IP address ranges.\n"},"local_recording":{"type":"boolean","description":"The local recording.","example":true},"record_audio_file":{"type":"boolean","description":"This setting records one audio file for all participants.","example":true,"default":false},"record_gallery_view":{"type":"boolean","description":"This setting records the gallery view.","example":true,"default":false},"record_speaker_view":{"type":"boolean","description":"This setting records the active speaker view.","example":true,"default":false},"recording_audio_transcript":{"type":"boolean","description":"The audio transcript.","example":true},"recording_disclaimer":{"type":"boolean","description":"This setting shows a disclaimer to participants before a recording starts.\nThis field has been deprecated. The replacement field is recording_notification_for_zoom_client","example":true,"deprecated":true},"smart_recording":{"type":"object","properties":{"create_recording_highlights":{"type":"boolean","description":"By selecting this option, meeting details in the audio transcript will be highlighted. Hosts can modify highlighted sections and generate a video summary (highlighted sections may have a 3-second offset) based on these sections. The summary is for informational purposes only and may not be complete.","example":true},"create_smart_chapters":{"type":"boolean","description":"By selecting this option, your recording will have chapters with overview. Hosts can edit the chapters.","example":true},"create_next_steps":{"type":"boolean","description":"By selecting this option, there will be a summary of actions to take after the recorded meeting.","example":true}},"description":"By selecting this option, your recording will have meeting smart chapters, and next steps. You are directing Zoom to access, process, and use your account's recording data for the purpose of analysis and insights."},"recording_password_requirement":{"type":"object","properties":{"have_letter":{"type":"boolean","description":"The passcode must contain at least one alphabetical letter (a, b, c..).","example":true},"have_number":{"type":"boolean","description":"The passcode must contain at least one number(1, 2, 3..).","example":true},"have_special_character":{"type":"boolean","description":"The passcode must contain at least one special character(!, @, #..).","example":true},"length":{"maximum":10,"type":"integer","description":"The minimum required length for the passcode.","example":10},"only_allow_numeric":{"type":"boolean","description":"The passcode must contain only numeric characters.","example":true}},"description":"This object represents the minimum passcode requirements set for recordings via Account Recording Settings."},"save_chat_text":{"type":"boolean","description":"This setting saves the chat text from the meeting.","example":true,"default":false},"show_timestamp":{"type":"boolean","description":"The show timestamp on the video.","example":true,"default":false},"recording_notification_for_zoom_client":{"type":"object","properties":{"disclaimer_to_participants":{"type":"string","description":"Update child setting name is [Show a disclaimer to participants when a recording starts]. All participants or Guest only.","example":"All participants","enum":["All participants","Guest only"]},"play_voice_prompt":{"type":"string","description":"Update child setting name is [Play voice prompt for]. All participants or Guest only or No one","example":"All participants","enum":["All participants","Guest only","No one"]},"ask_host_to_confirm":{"type":"boolean","description":"Update Child setting name is [Ask host to confirm before starting a recording], true: enable, false: disable","example":true}},"description":"You will update the setting name: Recording notifications - Zoom clients"},"allow_revenue_accelerator_manage_recording_separate_auto_delete":{"type":"boolean","description":"Allow Zoom Revenue Accelerator to manage recording files with separate auto-delete settings","example":true},"cloud_recording_permanently_deleted":{"type":"object","properties":{"cloud_recording_permanently_deleted_from_trash":{"type":"boolean","description":"Main setting value","example":true},"email_reminder_type":{"type":"string","description":"Selected email reminder","example":"Weekly digest on Monday","enum":["7 days before deletion","Weekly digest on Monday"]}},"description":"When the cloud recording is going to be permanently deleted from trash"},"allow_cmr_3rd_party_bot":{"type":"boolean","description":"Allow 3rd-party recording","example":true},"water_marker_recording":{"type":"boolean","description":"add water marker for recording","example":true},"viewer_see_transcript":{"type":"boolean","description":"Viewers can see the transcript","example":true},"allow_invitees_access_recordings_without_passcode":{"type":"boolean","description":"Allow invitees to access recordings without the passcode","example":true},"recording_as_on_demand":{"type":"boolean","description":"Set recording as on-demand by default","example":true},"recording_notifications_phone_users":{"type":"object","properties":{"require_press_one_consent_to_record":{"type":"boolean","description":"Require phone-only users to press 1 to consent to being recorded","example":true},"multiple_notifications_phone_users":{"type":"boolean","description":"Multiple notifications for phone users","example":true}},"description":"Recording notifications - Phone users"},"upload_recording":{"type":"boolean","description":"Upload recording to the cloud","example":true},"allow_add_cloud_recordings_to_zoom_clips":{"type":"boolean","description":"Allow users to add cloud recordings to Zoom Clips","example":true},"allow_share":{"type":"boolean","description":"Allow cloud recording sharing","example":true},"viewer_see_chat":{"type":"boolean","description":"Viewers see chat","example":true},"authenticated_view_cloud_recoding":{"type":"object","properties":{"authenticated_can_view_cloud_recordings":{"type":"boolean","description":"Main setting value","example":true},"default_authenticate_content":{"type":"string","description":"Default authentication option","example":"Signed-in users in my account","enum":["Signed-in users in my account","Sign in to Zoom","Sign in to Zoom with specified domains","Sign in to external Single Sign-On (SSO)","Only people with access"]}},"description":"Require users to authenticate before viewing cloud recordings"},"notification_subscription_url_when_recording_available":{"type":"boolean","description":"Push notification to subscription URL when a cloud recording is available","example":true},"recording_storage_email_notifications":{"type":"boolean","description":"Recording storage email notifications","example":true},"local_recording_options":{"type":"object","properties":{"internal_meeting_participants":{"type":"boolean","description":"Internal meeting participants","example":true},"internal_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"external_meeting_participants":{"type":"boolean","description":"External meeting participants","example":true},"external_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"participants_with_specified_domains":{"type":"boolean","description":"Meeting participants with specified domains","example":true},"participants_with_specified_domains_content":{"type":"string","description":"Enter the domain information","example":"zoom.us"},"participants_specified_domains_auto_approve_requests":{"type":"boolean","description":"Auto approve their permission requests","example":true},"save_chat_messages":{"type":"boolean","description":"Save chat messages from the meeting / webinar","example":true},"save_closed_caption":{"type":"boolean","description":"Save closed caption as a VTT file","example":true}},"description":"all sub-options for local recording"},"embed_passcode_in_shareable_link":{"type":"boolean","description":"Embed passcode in the shareable link for one-click access","example":true}}},"schedule_meeting":{"title":"User settings: Meeting settings","type":"object","properties":{"audio_type":{"type":"string","description":"This setting determines how participants can join the audio portion of the meeting: \n `both` - Telephony and VoIP. \n `telephony` - Audio PSTN telephony only. \n `voip` - VoIP only. \n `thirdParty` - Third party audio conference.","example":"both","default":"voip","enum":["both","telephony","voip","thirdParty"],"x-enum-descriptions":["Telephony and VoIP","Audio PSTN telephony only","VoIP only","3rd party audio conference"]},"default_password_for_scheduled_meetings":{"type":"string","description":"The passcode for already scheduled meetings.\n","example":"111111"},"embed_password_in_join_link":{"type":"boolean","description":"This setting encrypts the meeting passcode and includes the join meeting link to allow participants to join with just one click without having to enter the passcode.\n ","example":true},"force_pmi_jbh_password":{"type":"boolean","description":"This setting requires a passcode for personal meetings if attendees can join before host.","example":true},"host_video":{"type":"boolean","description":"The start meetings with host video on setting.","example":true},"join_before_host":{"type":"boolean","description":"This setting joins the meeting before the host arrives.","example":true},"meeting_password_requirement":{"type":"object","properties":{"consecutive_characters_length":{"type":"integer","description":"\nThis setting specifies the max length of consecutive characters(abcde...) that can be used in a passcode.\nIf you set the value of this field to `0`, no restriction will be applied on consecutive characters. \n\nIf you would like to set this restriction, you can specify a number between 4 and 8 that define the maximum allowed length for consecutive characters in a passcode.\n\nThe max allowed length will be `n-1` where `n` refers to the value you provide for this field. For instance, if you provide `4` as the value, there can only be a maximum of `3` consecutive characters in a passcode(example: abc1x@8fdh).","example":8,"enum":[0,4,5,6,7,8]},"have_letter":{"type":"boolean","description":"The passcode must contain at least 1 letter (such as a,b,c...).\n","example":true},"have_number":{"type":"boolean","description":"The passcode must contain at least one number (such as 1,2,3...).","example":true},"have_special_character":{"type":"boolean","description":"The passcode must have at least one special character (!,@,#...).","example":true},"have_upper_and_lower_characters":{"type":"boolean","description":"The passcode must include both uppercase and lowercase characters.","example":true},"length":{"type":"integer","description":"The minimum length that the meeting or webinar passcode must have.","example":10},"only_allow_numeric":{"type":"boolean","description":"The passcode must only contain numbers and no other characters.","example":true},"weak_enhance_detection":{"type":"boolean","description":"This setting informs users if the provided passcode is weak.","example":true}},"description":"The Account wide meeting/webinar [passcode requirements](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604)."},"participants_video":{"type":"boolean","description":"The start meetings with participants video on setting.","example":true},"personal_meeting":{"type":"boolean","description":"The personal meeting setting. \n \n \n`true`: Indicates that the **"Enable [Personal Meeting ID (PMI)](https://marketplace.zoom.us/docs/api-reference/using-zoom-apis#understanding-personal-meeting-id-pmi)"** setting is turned on. Users can choose to use a PMI for their meetings. \n \n \n`false`: Indicates that the **"Enable Personal Meeting ID"** setting is [turned off](https://support.zoom.us/hc/en-us/articles/201362843-Personal-meeting-ID-PMI-and-personal-link#h_aa0335c8-3b06-41bc-bc1f-a8b84ef17f2a). If this setting is disabled (`false`), meetings that were scheduled with a PMI will be invalid. Scheduled meetings must be manually updated.\nFor Zoom Phone only: If a user has been assigned a desk phone, **"Elevate to Zoom Meeting"** on desk phone will be disabled.\n\n\n","example":true},"pmi_password":{"type":"string","description":"The PMI passcode.\n","example":"123456"},"pstn_password_protected":{"type":"boolean","description":"This setting generates and requires the passcode for participants joining by phone.","example":true},"require_password_for_instant_meetings":{"type":"boolean","description":"This setting requires a passcode for instant meetings. If you use a PMI for your instant meetings, this option will be disabled. This setting is always enabled for free accounts and Pro accounts with a single host and cannot be modified for these accounts.\n","example":true},"require_password_for_pmi_meetings":{"type":"string","description":"This setting requires a passcode for Personal Meeting ID (PMI). This setting is always enabled for free accounts and Pro accounts with a single host and cannot be modified for these accounts.\n","example":"all","enum":["jbh_only","all","none"],"x-enum-descriptions":["Only meetings with Join Before Host enabled","All meetings using PMI","Disabled"]},"require_password_for_scheduled_meetings":{"type":"boolean","description":"This setting requires a passcode for meetings that have already been scheduled.\n","example":true},"require_password_for_scheduling_new_meetings":{"type":"boolean","description":"This setting requires a passcode when scheduling new meetings. This setting is always enabled for free accounts and Pro accounts with a single host and cannot be modified for these accounts.\n","example":true},"use_pmi_for_instant_meetings":{"type":"boolean","description":"This setting indicates the use of a [Personal Meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi) when starting an instant meeting.","example":true},"use_pmi_for_scheduled_meetings":{"type":"boolean","description":"This setting indicates the use of a [Personal Meeting ID (PMI)](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#understanding-personal-meeting-id-pmi) when scheduling a meeting.","example":true}}},"telephony":{"title":"Telephony update settings: Meeting settings","type":"object","properties":{"audio_conference_info":{"maxLength":2048,"type":"string","description":"The third-party audio conference info.","example":"test","default":""},"show_international_numbers_link":{"type":"boolean","description":"This setting shows the international numbers link on the invitation email.","example":true},"telephony_regions":{"type":"object","properties":{"selection_values":{"type":"string","description":"The account's selected telephony regions that indicate where most participants call into or call from during a meeting.","example":"CNTB"}},"description":"This setting indicates where most of the participants call into or call from during a meeting."},"third_party_audio":{"type":"boolean","description":"The third-party audio conference.","example":true}},"description":"User Settings: Telephony."},"tsp":{"title":"User settings: TSP settings","type":"object","properties":{"call_out":{"type":"boolean","description":"The call out.","example":true},"call_out_countries":{"type":"array","description":"The call out countries or regions setting","items":{"type":"object"}},"show_international_numbers_link":{"type":"boolean","description":"This setting shows the international numbers link on the invitation email.","example":true},"global_dial_in_countries":{"type":"object","properties":{"selected_countries":{"type":"array","description":"The list of selected countries/regions whose dial-in numbers will be listed in the email invitation. You can adjust the order that the dial-in numbers appear in the email invitation.","items":{"type":"object","properties":{"code":{"type":"string","description":"The code of the country or region.","example":"CN"},"name":{"type":"string","description":"The name of the country or region.","example":"China"}}}}},"description":"The user's **Global Dial-in Countries/Regions** settings."}},"description":"Account Settings: TSP."}}},{"title":"GroupSettingsAuthenticationUpdate","type":"object","oneOf":[{"type":"object","properties":{"authentication_option":{"type":"object","properties":{"action":{"type":"string","description":"The authentication action.","example":"update","enum":["update","show","hide"]},"default_option":{"type":"boolean","description":"The authentication default option.","example":true},"domains":{"type":"string","description":"The authentication domains.","example":"example.com"},"id":{"type":"string","description":"The authentication ID.","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"The authentication name.","example":"Authentication name"},"type":{"type":"string","description":" The authentication type. Specify one of the following authentication types for the authentication profile: \n \n * `enforce_login`: This option allows any users to join the meeting or webinar, as long as they are signed into their Zoom account.\n * `enforce_login_with_domains`: This option, allows you to specify a rule so that only those Zoom users whose email addresses contain a certain domain, can join the meeting or webinar. You can either add multiple domains using a comma in between and/or use a wildcard for listing domains. \n \n * `enforce_login_with_same_account`: This option allows users to join the meeting or webinar with the same Zoom account.","example":"enforce_login_with_domains","enum":["enforce_login","enforce_login_with_same_account","enforce_login_with_domains"]}},"description":"The meeting authentication options."},"meeting_authentication":{"type":"boolean","description":"Only authenticated users can join meetings","example":true}}},{"type":"object","properties":{"authentication_option":{"type":"object","properties":{"action":{"type":"string","description":"The authentication action.","example":"update","enum":["update","show","hide"]},"default_option":{"type":"boolean","description":"The authentication default option.","example":true},"domains":{"type":"string","description":"The authentication domains.","example":"example.com"},"id":{"type":"string","description":"The authentication ID.","example":"ewf22f42fewf4232fgg4343lki4"},"name":{"type":"string","description":"The authentication name.","example":"Authentication name"},"type":{"type":"string","description":"The authentication type.","example":"enforce_login_with_domains","enum":["internally","enforce_login","enforce_login_with_domains"]}},"description":"The authentication options."},"recording_authentication":{"type":"boolean","description":"Only authenticated users can view cloud recordings","example":true}}}]},{"title":"Meeting/Webinar Security Settings","type":"object","properties":{"meeting_security":{"type":"object","properties":{"auto_security":{"type":"boolean","description":"Whether to require that all meetings are secured with at least one security option. \n\n This setting can only be disabled by Enterprise, ISV, Business (with more than 100 licenses), and Education accounts.","example":true},"block_user_domain":{"type":"boolean","description":"Whether to block users in specific domains from joining meetings and webinars.","example":true},"block_user_domain_list":{"maxItems":20,"type":"array","description":"The domain to block, up to 20 domains. For example, the `*.example.com` domain.","items":{"maxLength":30,"minLength":5,"type":"string","example":"*.example.com"}},"embed_password_in_join_link":{"type":"boolean","description":"Whether the meeting passcode will be encrypted and included in the invitation link. The provided link will allow participants to join the meeting without having to enter the passcode.","example":true},"encryption_type":{"type":"string","description":"The type of encryption to use when starting a meeting: \n* `enhanced_encryption` — Use enhanced encryption. Encryption data is stored in the cloud. \n* `e2ee` — End-to-end encryption. The encryption key is stored on the local device and cannot be obtained by anyone else. Enabling E2EE also [**disables** certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":"e2ee","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Whether to enable end-to-end encryption for meetings. If enabled, you can specify the type of encryption in the `encryption_type` field.","example":true},"meeting_password":{"type":"boolean","description":"Whether all instant and scheduled meetings that users can join via client or Zoom Rooms systems are passcode-protected. [Personal Meeting ID (PMI)](https://support.zoom.us/hc/en-us/articles/203276937) meetings are **not** included in this setting.","example":true},"meeting_password_requirement":{"type":"object","properties":{"consecutive_characters_length":{"type":"integer","description":"The maximum length of consecutive characters (for example, `abcdef`) allowed in a passcode: \n* `4` through `8` — The maximum consecutive characters length. The length is `n` minus `1`, where `n` is the provided value. For example, if you provide the `4` value, there can only be a maximum of `3` consecutive characters in a passcode (for example, `abc1x@8fdh`). \n* `0` — Do not apply a consecutive character restriction.","example":8,"enum":[0,4,5,6,7,8]},"have_letter":{"type":"boolean","description":"Whether the passcode must contain at least one letter character.","example":true},"have_number":{"type":"boolean","description":"Whether the passcode must contain at least one numeric character.","example":true},"have_special_character":{"type":"boolean","description":"Whether the passcode must contain at least one special character. For example, `!`, `@`, and/or `#` characters.","example":true},"have_upper_and_lower_characters":{"type":"boolean","description":"Whether the passcode must include uppercase and lowercase characters.","example":true},"length":{"type":"integer","description":"The passcode's minimum length.","example":10},"only_allow_numeric":{"type":"boolean","description":"Whether the passcode must contain **only** numeric characters.","example":true},"weak_enhance_detection":{"type":"boolean","description":"Whether users will be informed when the provided passcode is weak.","example":true}},"description":"The information about the meeting and webinar [passcode requirements](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604)."},"only_authenticated_can_join_from_webclient":{"type":"boolean","description":"Whether to specify that only authenticated users can join the meeting from the web client.","example":true},"phone_password":{"type":"boolean","description":"Whether to require a passcode for participants joining by phone. \n\n If enabled and the meeting is passcode-protected, a numeric passcode is required for participants to join by phone. For meetings with alphanumeric passcodes, a numeric passcode will be generated.","example":true},"pmi_password":{"type":"boolean","description":"Whether all Personal Meeting ID (PMI) meetings that users can join via client or Zoom Rooms systems are passcode-protected.","example":true},"require_password_for_scheduled_meeting":{"type":"boolean","description":"Whether to require a passcode for meetings that have already been scheduled.","example":true},"require_password_for_scheduled_webinar":{"type":"boolean","description":"Whether to require a passcode for webinars that have already been scheduled.","example":true},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting. \n\n If the **Waiting Room** feature is enabled, the [**Allow participants to join before host**](https://support.zoom.us/hc/en-us/articles/202828525-Allow-participants-to-join-before-host) setting is automatically disabled.","example":true},"waiting_room_settings":{"type":"object","properties":{"participants_to_place_in_waiting_room":{"type":"integer","description":"The type of participants to be admitted to the Waiting Room: \n* `0` — All attendees. \n* `1` — Users who are not in your account. \n* `2` — Users who are not in your account and are not part of your [allowed domains list](https://support.zoom.us/hc/en-us/articles/360037117472-Configuring-authentication-profiles#h_e3cf0d5f-eec7-4c2a-ad29-ef2a5079a7da).","example":1,"enum":[0,1,2]},"users_who_can_admit_participants_from_waiting_room":{"type":"integer","description":"The users who can admit participants from the Waiting Room: \n* `0` — Host and co-hosts only. \n* `1` — Host, co-hosts, and anyone who bypassed the Waiting Room if the host and co-hosts are not present.","example":1,"enum":[0,1]},"whitelisted_domains_for_waiting_room":{"type":"string","description":"If the `participants_to_place_in_waiting_room` field is `2`, a comma-separated list of the domains that can bypass the Waiting Room (`"example.com,example2.com"`).","example":"example.com"}},"description":"The information about the waiting room settings."},"webinar_password":{"type":"boolean","description":"Whether to generate a passcode when scheduling webinars. Participants must use the generated passcode to join the scheduled webinar.","example":true}}}},"description":"The updated meeting and webinar security settings."}]}}}},"responses":{"204":{"description":"**HTTP Status Code:** `200` \n \nUser settings updated"},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `1108`
\n Only Licensed or On-prem users can enable the large meeting feature.
\n**Error Code:** `1204`
\n You can't enable the Webinar feature because you already have the Zoom Events feature.
\n**Error Code:** `1205`
\n You can't enable the Zoom Events feature because you already have the Webinar feature.
\n**Error Code:** `1206`
\n You can only enable the Zoom Events feature for Licensed or On-prem users.
\n**Error Code:** `1120`
\n A valid invitation to join the Zoom account was not found for this user.
\nThis error is thrown if you added a user in your account but the user did not accept the invitation on time and the invitation expired - thus making the userId invalid.
\n**Error Code:** `1122`
\n Webinar feature can only be enabled for Licensed or On-prem users.
\n**Error Code:** `200`
\n You can't add paid users.
\nYou can add max $maxNumber paid users.
\nYou can add max $maxNumber free users.
\nYou can add max $maxNumber Webinar 100 users.
\nYou can add max $maxNumber Webinar 500 users.
\nYou can add max $maxNumber Webinar 1000 users.
\nYou can add max $maxNumber Webinar 3000 users.
\nYou can add max $maxNumber Webinar 5000 users.
\nYou can add max $maxNumber Webinar 10000 users.
\nYou can add max $maxNumber Large 100 users.
\nYou can add max $maxNumber Large 200 users.
\nYou can add max $maxNumber Large 300 users.
\nYou can add max $maxNumber Large 500 users.
\nYou can add max $maxNumber Large 1000 users.
\nYou can add max $maxNumber paid users.
\n**Error Code:** `300`
\n You cannot downgrade the Zoom Events feature to \"$downgradeCapacity\" capacity because there is an upcoming Zoom Events scheduled with \"$maxCapacity\" capacity.
You cannot remove the Zoom Events feature for this user because the user has an upcoming Zoom Events scheduled.
You cannot assign a Zoom Customer Managed Key license for a single user.
You can't enable Zoom Events/Zoom Events Unlimited/Zoom Sessions Unlimited feature for a user at the same time for a user.
You can't remove the Zoom Events/Zoom Events SAAS/Zoom Events Consumption feature for this user because the user has an upcoming Zoom Events scheduled.
You can't downgrade the Zoom Events to \"$downgradeCapacity\" capacity because there is an upcoming Zoom Events scheduled with \"$maxCapacity\" capacity.
You can only enable Zoom Events Unlimited/Zoom Sessions Unlimited feature for Licensed or On-prem users.
You can only enable Zoom Events Pay Per Attendee/Zoom Sessions Pay Per Attendee feature for Licensed or On-prem users.
You can add max \"$maxCapacity\" users for this Zoom Events Unlimited plan.
You can add max \"$maxCapacity\" users for this Zoom Sessions Unlimited plan.
You can't downgrade Zoom Events Unlimited plan to Zoom Sessions Unlimited plan.
You can't enable Zoom Events/Zoom Events Unlimited/Zoom Sessions Unlimited feature and Webinar feature at the same time.
The events plan you want to assign does not exist.
You can't enable Zoom Events and Zoom Events Unlimited feature for a user at the same time for a user.
You can't enable Zoom Events Pay Per Attendee and Zoom Sessions Pay Per Attendee feature for a user at the same time for a user.
You can't remove all Zoom Events features for this user because the user has an upcoming Zoom Events scheduled.
You can add max \"$maxCapacity\" users for this \"${planName}\" plan.
\n**Error Code:** `1207`
\n You can only enable the \"Concurrent Meeting\" feature for Licensed users or On-prem users.
\n**Error Code:** `1208`
\n You can't enable the \"Concurrent Meeting Basic\" feature.
\n**Error Code:** `1209`
\n You can add a maximum of {0} \"Concurrent Meeting Basic\" users.
\n**Error Code:** `1210`
\n You can't enable the \"Concurrent Meeting Plus\" feature.
\n**Error Code:** `1211`
\n You can add a maximum of {0} \"Concurrent Meeting Plus\" users.
\n**Error Code:** `1228`
\n Unable to assign \"Zoom IQ for Sales\" license because you have reached the limit of licensed users allowed on this account or this account does not have the \"Zoom IQ for Sales\" plan.
Unable to assign \"Zoom Whiteboard\" license because you have reached the limit of licensed users allowed on this account or this account does not have the \"Zoom Whiteboard\" plan.
\n**Error Code:** `1233`
\n You cannot enable the \"Zoom IQ for Sales\" for that Zoom Rooms user.
You cannot enable the \"Zoom Whiteboard\" for that Zoom Rooms user.
\n**Error Code:** `1234`
\n You cannot enable the \"Zoom IQ for Sales\" for an On-Prem user.
\n**Error Code:** `1242`
\n You cannot set \"Zoom Whiteboard\" and \"Zoom Whiteboard Plus\" at the same time.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:update:settings","user:update:settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:update:settings","user:update:settings:admin"]}}},"/users/{userId}/settings/virtual_backgrounds":{"post":{"tags":["Users"],"summary":"Upload Virtual Background files","description":"Use this API to [upload a Virtual Background files](https://support.zoom.us/hc/en-us/articles/210707503-Virtual-Background) to a user's profile. For user-level apps, pass [the `me` value](https://marketplace.zoom.us/docs/api-reference/using-zoom-apis#mekeyword) instead of the `userId` parameter. \n\n **Note:** \n* A user profile cannot exceed more than 10 Virtual Background files. \n* You can only upload image files that are in JPG/JPEG, GIF or PNG format. \n* Video files must be in MP4 or MOV file format with a minimum resolution of 480 by 360 pixels (360p) and a maximum resolution of 1920 by 1080 pixels (1080p). \n* The Virtual Background file size cannot exceed 15 megabytes (MB). \n\n **Prerequisites:** \n* The [Virtual Background feature](https://support.zoom.us/hc/en-us/articles/210707503-Virtual-Background#h_2ef28080-fce9-4ac2-b567-dc958afab1b7) must be enabled on the account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:virtual_background_files`,`user:write:virtual_background_files:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"uploadVBuser","parameters":[{"name":"userId","in":"path","description":"The user's ID. To get a user's ID, use the [**List users**](/api-reference/zoom-api/ma#operation/users) API. For user-level apps, pass the `me` value instead of the user ID value.","required":true,"schema":{"type":"string","example":"KDcuGIm1QgePTO8WbOqwIQ"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"The Virtual Background's file path.","example":"profile.png"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **Created**","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The virtual background file's ID.","example":"_l0MP1U7Qn2JgJ4oEJbVZQ"},"is_default":{"type":"boolean","description":"Whether the virtual background file is set as the default virtual background: \n* `true` — The default virtual background. \n* `false` — Not the default virtual background.","example":true},"name":{"type":"string","description":"The virtual background file's name.","example":"profile.png"},"size":{"type":"integer","description":"The virtual background file's size, in bytes.","example":7221},"type":{"type":"string","description":"The virtual background file's file type: \n* `image` — An image file. \n* `video` — A video file.","example":"image","enum":["image","video"]}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `120`
\n No file uploaded, verify that a file has been uploaded.
\nFile size cannot exceed 15M.
\nA maximum of 10 files are allowed for a user.
\nOnly jpg/jpeg, gif or png image file can be uploaded.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n "},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:write:virtual_background_files","user:write:virtual_background_files:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:write:virtual_background_files","user:write:virtual_background_files:admin"]}},"delete":{"tags":["Users"],"summary":"Delete Virtual Background files","description":"Use this API to delete a user's Virtual Background files. For user-level apps, pass [the `me` value](https://marketplace.zoom.us/docs/api-reference/using-zoom-apis#mekeyword) instead of the `userId` parameter. \n\n **Prerequisites:** \n* The [Virtual Background feature](https://support.zoom.us/hc/en-us/articles/210707503-Virtual-Background#h_2ef28080-fce9-4ac2-b567-dc958afab1b7) must be enabled on the account.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:delete:virtual_background_files`,`user:delete:virtual_background_files:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"delUserVB","parameters":[{"name":"userId","in":"path","description":"The user's ID. To get a user's ID, use the [**List users**](/docs/api-reference/zoom-api/ma#operation/users) API. For user-level apps, pass the `me` value instead of the user ID value.","required":true,"schema":{"type":"string","example":"KDcuGIm1QgePTO8WbOqwIQ"}},{"name":"file_ids","in":"query","description":"A comma-separated list of the Virtual Background file IDs to delete.","required":false,"schema":{"type":"string","example":"_l0MP1U7Qn2JgJ4oEJbVZQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \n* No content. \n* Deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `300`
\n Invalid parameter: file_ids
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n * User does not exist. \n* User \"{userId}\" does not exist or does not belong to this account.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:delete:virtual_background_files","user:delete:virtual_background_files:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:delete:virtual_background_files","user:delete:virtual_background_files:admin"]}}},"/users/{userId}/status":{"put":{"tags":["Users"],"summary":"Update user status","description":"[Deactivate](https://support.zoom.us/hc/en-us/articles/115005269946-Remove-User-from-your-Account#h_6a9bc1c3-d739-4945-b1f2-00b3b88fb5cc) an active user or to [reactivate](https://support.zoom.us/hc/en-us/articles/115005269946-Remove-User-from-your-Account#h_16319724-d120-4be6-af5d-31582d134ea0) a deactivated user. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nAn account owner or admins can deactivate as well as activate a user in a Zoom account. Deactivating a user removes all licenses associated with a user, and prevents the deactivated user from logging into their Zoom account. A deactivated user can be reactivated. Reactivating a user grants the user access to log in to their Zoom account.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:update:status`,`user:update:status:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userStatus","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"User status.","content":{"application/json":{"schema":{"required":["action"],"type":"object","properties":{"action":{"type":"string","description":"The action types.\n `activate` - Activate a deactivated user. \n `deactivate` - Deactivate a user. \n `clock_in` - Clock in a user. \n `clock_out` - Clock out a user.","example":"deactivate","enum":["activate","deactivate","clock_in","clock_out"],"x-enum-descriptions":["set users status to active","set users status to inactive","set users status to clock in","set users status to clock out"]},"transfer_events":{"type":"boolean","description":"Indicates whether to transfer Zoom Events hub assets. This option is supported only for user deactivation operations.\n\nWhen `transfer_events` is set to `true`, the `transfer_email` field is required. Upon user deactivation, the user’s Zoom Events hub assets will be transferred to the specified target user.\nWhen `transfer_events` is set to `false`, the `transfer_email` field is not required, and no Zoom Events hub asset transfer will be performed.","example":true},"transfer_email":{"type":"string","description":"Transfer email. The email address of the target user who will receive the Zoom Events hub assets transferred from the deactivated user. This field is **required** when `transfer_events` is set to `true`.","example":"xxx@example.com"}},"description":"The action."}}}},"responses":{"204":{"description":"OK"},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `200`
\n Zoom Room and Admin users' status cannot be activated or deactivated.
\n**Error Code:** `300`
\n You cannot deactivate this user because the user has an upcoming Zoom Events scheduled.
\n**Error Code:** `3412`
\n * Your request to activate the user was not approved at this time because your account has reached the permitted maximum number of $maxAllowedNumber \"Basic\" users. Remove the existing \"Basic\" user(s) from your \"Users\" list or the \"Pending Users\" list before attempting to activate this user. \n* Your request to activate the user was not approved at this time because your account has reached the permitted maximum number of $maxAllowedNumber no-meeting-license users. Remove the existing no-meeting-license user(s) from your \"Users\" list or the \"Pending Users\" list before attempting to activate this user.
\n**Error Code:** `2033`
\n Your request to activate the \"Basic\" user was not approved because you have already reached the maximum \"Basic\" user limit allowed in your account. For additional help regarding this issue, contact the Zoom Customer Support team.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:update:status","user:update:status:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:update:status","user:update:status:admin"]}}},"/users/{userId}/token":{"get":{"tags":["Users"],"summary":"Get a user's token","description":"Gets a user's Zoom token or Zoom Access Key (ZAK). \n\nFor user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter. \n\n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read`,`user:write`,`user:read:admin`,`user:write:admin`,`user_profile`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:read:token`,`user:read:token:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userToken","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string","example":"abc"}},{"name":"type","in":"query","description":"The user token type. \n* `zak` - A Zoom Access Key (ZAK) is used to generate a URL to start meetings. See [Getting a Zoom Access Key (ZAK)](https://developers.zoom.us/docs/meeting-sdk/auth/#start-meetings-and-webinars-with-a-zoom-users-zak-token) for details. The ZAK's expiration time is two hours. For API users, the expiration time is 90 days. An API user is a user created via the `custCreate` action in the **[Create users](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/userCreate)** API. The maximum length of this value is `512`. \n* `token` - **Deprecated** A Zoom token. This token expires in 14 days. You must make the request again after expiration to receive a new token. This query parameter returns a null value if the user signed in to Zoom via Google or Facebook. The maximum length of this value is `512`. \n* `onbehalf` - A Zoom token that establishes a delegation relationship between a Zoom user and a Meeting SDK app. It allows the SDK app to join the same meeting as the Zoom user and act on their behalf in an assistant role. The SDK app cannot use this token to join meetings independently without the Zoom user present. This token expires in 2 hours; you must request a new token after it expires.\n\n This value defaults to `token`.","required":false,"schema":{"maxLength":512,"type":"string","example":"zak","default":"token","enum":["token","zak","onbehalf"]}},{"name":"ttl","in":"query","description":"The ZAK/onbehalf expiration time to live (TTL), in seconds. To update the user's ZAK/onbehalf TTL, use this field with the `zak` or `onbehalf` value for the `type` query parameter. \n\nDefaults to `7200` or `7776000` (90 days) for API users. The maximum value is one year.","required":false,"schema":{"type":"integer","example":7200,"default":7200}},{"name":"meeting_id","in":"query","description":"The meeting's ID, use this field with the `onbehalf` value for the `type` query parameter.","required":false,"schema":{"type":"string","example":"123456"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` \n \nIf the request uses `type=token` and the account is not on the allowlist, the response will be: \"Token is no longer supported. Please use ZAK token instead.\" If the account is on the allowlist with `type=token`, or if `type=zak` is used, the token will be returned.","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"The user's ZAK or token value.","example":"6IjAwMDAwMSIsInptX3NrbSI6InptX"}}}}}},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `124`
\n Access token is expired. Invalid access token.
\n**Error Code:** `2300`
\n This API endpoint is not recognized.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:read","user:write","user:read:admin","user:write:admin","user_profile","user:read:token","user:read:token:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Read"],"x-macro-scopes":["user:read","user:write","user:read:admin","user:write:admin","user_profile"],"x-granular-scopes":["user:read:token","user:read:token:admin"]}},"delete":{"tags":["Users"],"summary":"Revoke a user's SSO token","description":"Revokes a user's SSO token. For user-level apps, pass [the `me` value](https://developers.zoom.us/docs/api/rest/using-zoom-apis/#the-me-keyword) instead of the `userId` parameter.\n\nAfter calling this API, the SSO user will be logged out of their current Zoom session.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:write:admin`,`user:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `user:delete:token`,`user:delete:token:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userSSOTokenDelete","parameters":[{"name":"userId","in":"path","description":"The user's user ID or email address. For user-level apps, pass the `me` value.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` \n \nToken deleted."},"400":{"description":"**HTTP Status Code:** `400`
\n Bad Request \n\n **Error Code:** `124`
\n Access token is expired. Invalid access token.
\n**Error Code:** `2300`
\n This API endpoint is not recognized.
\n"},"404":{"description":"**HTTP Status Code:** `404`
\n Not Found \n\n **Error Code:** `1001`
\n User does not exist: $userId.
\n"},"429":{"description":"**HTTP Status Code:** `429`
\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["user:write:admin","user:write","user:delete:token","user:delete:token:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["User:Edit"],"x-macro-scopes":["user:write:admin","user:write"],"x-granular-scopes":["user:delete:token","user:delete:token:admin"]}}}},"components":{"securitySchemes":{"openapi_authorization":{"type":"apiKey","name":"Authorization","in":"header"},"openapi_oauth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/","tokenUrl":"","refreshUrl":"","scopes":{"contact_group:write:admin":"contact_group:write:admin","contact_group:read:admin":"contact_group:read:admin"," division:read:admin":" division:read:admin","division:read:list_divisions:admin":"division:read:list_divisions:admin","division:wirte:admin":"division:wirte:admin","division:write:division:admin":"division:write:division:admin","division:read:division:admin":"division:read:division:admin","division:update:division:admin":"division:update:division:admin","division:delete:division:admin":"division:delete:division:admin","division:read:member:admin":"division:read:member:admin","division:write:member:admin":"division:write:member:admin","group:write:admin":"group:write:admin","group:write:group:admin":"group:write:group:admin","group:read:admin":"group:read:admin","group:read:list_groups:admin":"group:read:list_groups:admin","group:update:group:admin":"group:update:group:admin","group:delete:group:admin":"group:delete:group:admin","group:read:group:admin":"group:read:group:admin","group:write:administrator:admin":"group:write:administrator:admin","group:read:administrator:admin":"group:read:administrator:admin","group:delete:administrator:admin":"group:delete:administrator:admin","group:read:list_channels:admin":"group:read:list_channels:admin","group:update:lock_settings:admin":"group:update:lock_settings:admin","group:read:lock_settings:admin":"group:read:lock_settings:admin","group:write:member:admin":"group:write:member:admin","group:read:list_members:admin":"group:read:list_members:admin","group:update:member:admin":"group:update:member:admin","group:delete:member:admin":"group:delete:member:admin","group:update:settings:admin":"group:update:settings:admin","group:read:settings:admin":"group:read:settings:admin","group:update:registration_settings:admin":"group:update:registration_settings:admin","group:read:registration_settings:admin":"group:read:registration_settings:admin","group:write:virtual_background_files:admin":"group:write:virtual_background_files:admin","group:delete:virtual_background_files:admin":"group:delete:virtual_background_files:admin","user:read":"user:read","user:write":"user:write","user:read:admin":"user:read:admin","user:write:admin":"user:write:admin","user:read:list_users:admin":"user:read:list_users:admin","user:write:user:admin":"user:write:user:admin","user:read:email":"user:read:email","user:read:email:admin":"user:read:email:admin","user:write:feature:admin":"user:write:feature:admin","user_zak:read":"user_zak:read","user:read:zak":"user:read:zak","user:read:zak:admin":"user:read:zak:admin","user:read:summary:admin":"user:read:summary:admin","user:read:pm_room":"user:read:pm_room","user:read:pm_room:admin":"user:read:pm_room:admin","user_profile":"user_profile","user_info:read":"user_info:read","user:read:user":"user:read:user","user:read:user:admin":"user:read:user:admin","user:update:user":"user:update:user","user:update:user:admin":"user:update:user:admin","user:delete:user":"user:delete:user","user:delete:user:admin":"user:delete:user:admin","user:read:list_assistants":"user:read:list_assistants","user:read:list_assistants:admin":"user:read:list_assistants:admin","user:write:assistant":"user:write:assistant","user:write:assistant:admin":"user:write:assistant:admin","user:delete:assistant":"user:delete:assistant","user:delete:assistant:admin":"user:delete:assistant:admin","user:read:list_collaboration_devices":"user:read:list_collaboration_devices","user:read:list_collaboration_devices:admin":"user:read:list_collaboration_devices:admin","user:read:collaboration_device":"user:read:collaboration_device","user:read:collaboration_device:admin":"user:read:collaboration_device:admin","user:update:email":"user:update:email","user:update:email:admin":"user:update:email:admin","user:read:settings":"user:read:settings","user:read:settings:admin":"user:read:settings:admin","user:update:password":"user:update:password","user:update:password:admin":"user:update:password:admin","user:read:list_permissions":"user:read:list_permissions","user:read:list_permissions:admin":"user:read:list_permissions:admin","user:write:profile_picture":"user:write:profile_picture","user:write:profile_picture:admin":"user:write:profile_picture:admin","user:update:presence_status":"user:update:presence_status","user:update:presence_status:admin":"user:update:presence_status:admin","user:read:presence_status":"user:read:presence_status","user:read:presence_status:admin":"user:read:presence_status:admin","user:delete:scheduler":"user:delete:scheduler","user:delete:scheduler:admin":"user:delete:scheduler:admin","user:read:list_schedulers":"user:read:list_schedulers","user:read:list_schedulers:admin":"user:read:list_schedulers:admin","user:update:settings":"user:update:settings","user:update:settings:admin":"user:update:settings:admin","user:delete:virtual_background_files":"user:delete:virtual_background_files","user:delete:virtual_background_files:admin":"user:delete:virtual_background_files:admin","user:write:virtual_background_files":"user:write:virtual_background_files","user:write:virtual_background_files:admin":"user:write:virtual_background_files:admin","user:update:status":"user:update:status","user:update:status:admin":"user:update:status:admin","user:read:token":"user:read:token","user:read:token:admin":"user:read:token:admin","user:delete:token":"user:delete:token","user:delete:token:admin":"user:delete:token:admin"}}}}}}}