Transfer Users of a User Type
Purpose
To transfer the users of a user type to another user type in a portal.
Request Details
Request URL
{api-domain}/crm/{version}/settings/portals/{portal_name}/user_type/{user_type_id}/users/action/transfer
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.settings.clientportal.ALL
(or)
Scope=ZohoCRM.settings.clientportal.UPDATE
Parameters
- transfer_Tomandatory
The ID of the user type to which you want to transfer the users.
- personality_idsmandatory
Comma-separated IDs of the users you want to transfer to the new user type.
Sample Request
Copied
Possible Errors
- INVALID_DATAHTTP 400
- Invalid personality ID. Either the personality does not belong to any portal user or it does not belong to this user type, or the user type is invalid.
Resolution: Specify the correct personality ID. - You are trying to transfer the users to custom user type.
Resolution: you can only transfer users to the custom user type.
- Invalid personality ID. Either the personality does not belong to any portal user or it does not belong to this user type, or the user type is invalid.
- REQUIRED_PARAM_MISSINGHTTP 400
- You have not specified either transfer_To or personality_ids.
Resolution:transfer_To or personality_ids are mandatory parameters.
- You have not specified either transfer_To or personality_ids.
- LICENSE_LIMIT_EXCEEDEDHTTP 403
You have exceeded the license limit for portals for your org.
Resolution: Contact your administrator or support@zohodeveloper.com to purchase user type add-on. - NO_PERMISSIONHTTP 403
The "Client Portal User" permission is disabled.
Resolution: Contact your administrator and set up the "Client Portal User" to transfer the users.
Sample Response
Copied