Creates a new user account in the cloud organization with the specified role, username, and email. The user receives an invitation email immediately upon creation.
https://{serverurl}/dcapi/users-cloud
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Specifies the request payload format. Set to application/userAddition.v1+json to submit the user data in JSON format.
Email address of the user. This will be used for user communication and login.
Unique username for the user. This will be used for login credentials.
Role identifier to assign to the user. To get available role IDs, use this API. Get Role ID
curl --request POST \
--url https://appdomains/dcapi/users-cloud \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/userAddition.v1+json' \
--data '{"roleID":"9502000000014452","mailID":"john.smith@example.com","userName":"john.smith"}'Create a new cloud user with email, username, and assigned role.
{
"roleID": "9502000000014452",
"mailID": "john.smith@example.com",
"userName": "john.smith"
}
Unique login identifier assigned to the newly created user.
confirmation message for the create-user operation.
Indicates whether the created user is a newly invited user (true) or an existing user (false).
Application-specific error code indicating the reason for the request failure.
Error message describing the cause of the error.
Successful create user response with assigned login ID and confirmation.
{
"loginID": "9502000000122681",
"statusMsg": "User john.smith has been invited successfully",
"newUser": true
}
Error response when attempting to create a user with an email address that already exists.
{
"errorCode": "1107",
"errorMsg": "User johny@zohocorp.com already exists"
}
Error response when the user name is null or empty.
{
"errorCode": "1103",
"errorMsg": "UserName Should not be null or empty"
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.