Add a user

Add a new user to the organization and receive the user ID upon a successful API call.

Endpoints

POST /users

Request URL

Bigin APIs are available across eight different domains, and you must choose the one relevant to your data center (DC):

POSThttps://www.zohoapis.com/bigin/v2/users

POSThttps://www.zohoapis.eu/bigin/v2/users

POSThttps://www.zohoapis.com.au/bigin/v2/users

POSThttps://www.zohoapis.in/bigin/v2/users

POSThttps://www.zohoapis.com.cn/bigin/v2/users

POSThttps://www.zohoapis.jp/bigin/v2/users

POSThttps://www.zohoapis.sa/bigin/v2/users

POSThttps://www.zohoapis.ca/bigin/v2/users

Authorization

For this endpoint, pass the access token as an authorization header. See OAuth Authentication for more information about access tokens.

Authorization: Zoho-oauthtoken <ACCESS_TOKEN>

You must authenticate using an access token that is associated with one of the following scopes:

ZohoBigin.users.ALL
ZohoBigin.users.CREATE

Notes:

Only one user can be added per request.
In the request body, use field API names. Retrieve the api_name value for each field from the Fields metadata API.

Request parameters

The available request parameters are given below:

Body parameters

last_name stringRequired

The last name of the user.

first_name stringRequired

The first name of the user.

email stringRequired

The email ID of the user.

role stringRequired

The ID of the role to which the user will be assigned. You can get the Role ID from the Get all roles data API.

profile stringRequired

The ID of the profile to which the user will be assigned. You can get the Profile ID from the Get all profiles data API.

Sample request

Curl Deluge

Copiedcurl "https://www.zohoapis.com/bigin/v2/users" \
-X POST \
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf" \
-d "@newuser.json"

Copiednew_user = Map();
new_user.put("first_name","Patricia");
new_user.put("last_name", "Boyle");
new_user.put("email", "Patricia.Boyle@example.com");
new_user.put("role", "692969000000015969");
new_user.put("profile", "692969000000015972");

user_info = List();
user_info.add(new_user);

params = Map();
params.put("user_info", user_info);

response = invokeurl
[
	url: "https://www.zohoapis.com/bigin/v2/users"
	type: POST
	parameters: params.toString()
	connection:"connection_link_name"
];
info response ;

Sample request body

Copied//Consider the following data is saved in a file 'newuser.json'
{
    "users": [
        {
            "first_name": "Patricia",
            "last_name": "Boyle",
            "email": "Patricia.Boyle@example.com",
            "role": "692969000000015969",
            "profile": "692969000000015972"
        }
    ]
}

Response object

The response object provides information regarding the success message or status.

Possible error codes

The response of this resource includes HTTP status and error codes.

The most common HTTP error codes that occur when you request access to this endpoint are given in the following:

LICENSE_LIMIT_EXCEEDEDHTTP 400
Request exceeds your license limit. Need to upgrade in order to add.
Resolution: The maximum number of users you can add per your Bigin plan has exceeded. Please buy additional user licenses to add more users.
DUPLICATE_DATAHTTP 400
Failed to add user since same email id is already present
Resolution: The user you are trying to add already exists in your organization.
MANDATORY_NOT_FOUNDHTTP 400
Company Name is required
Resolution: Company name is not specified in the request body.
INVALID_DATAHTTP 400
Invalid data.
Resolution: Email Id should not contain @skydesk.jp. Please choose a different email id (OR) Invalid Email Id. Please choose a different email id The email ID is either invalid or contains @skydesk.jp.

Sample Response

Copied{
    "users": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "2034020000000630024"
            },
            "message": "User added",
            "status": "success"
        }
    ]
}