LeadSquared Developer Centre


Create a User

Lets you create a new user in your LeadSquared account.

Note: FirstName, EmailAddress and Role are mandatory parameters.

If you’re a sales group manager, you can use this API to create a new user and also add the user to your sales group. Just add the additional parameters to your JSON request –

"AssociatedGroups": [{
"GroupId": "022bc5d4-0fba-11e8-871e-02bf1924461c",
"ViewAllLeadsOfGroup": 1,
"ModifyAllLeadsOfGroup": 0,
"AddUsersToGroup": 0,
"ViewAllAccountsOfGroup": 0 ,
"ModifyAllAccountsOfGroup": 0


POST https://{host}/v2/UserManagement.svc/User/Create?accessKey=AccessKey&secretKey=SecretKey


Content-Type: application/json
JSON Body/Payload Icon

Request Parameters

Parameter Description

The user’s first name. This parameter is mandatory.


The user’s last name.


The user’s email address. This parameter is mandatory.


The user’s role. Accepted values include – Administrator, Marketing_User, Sales_Manager, Sales_User. This parameter is mandatory.


Pass the Schema Name and the value of the custom user fields you want to update. To obtain this, navigate to My Profile>Settings>Users and Permissions>User Fields.


Enter the phone number associated with the user. For example, +91-9876543210


Pass true if you want the user to see the agent pop-up. Pass false if you don’t.


Pass 0 to create a web user. Pass 1 to create a mobile user.


The Id of the user’s manager. You can use the Get Users API to retrieve the user Id.


Pass the user’s mobile phone number here.


Accepted values are –

Pacific/Samoa US/Hawaii US/Alaska US/Pacific US/Arizona Canada/Mountain US/Mountain America/Mexico_City US/Central America/Guatemala Canada/Saskatchewan US/East-Indiana America/Bogota US/Eastern America/Manaus America/Caracas America/Santiago Canada/Atlantic Canada/Newfoundland America/Argentina/Buenos_Aires America/Godthab America/Bahia Etc/GMT-2 Atlantic/Cape_Verde Atlantic/Azores Africa/Casablanca Europe/London Europe/Amsterdam Africa/Algiers Europe/Brussels Europe/Sarajevo Europe/Belgrade Africa/Windhoek Africa/Harare Asia/Jerusalem Europe/Athens Europe/Kiev Egypt Europe/Minsk Europe/Moscow Africa/Nairobi Asia/Baghdad Asia/Kuwait Asia/Tehran Asia/Tbilisi Asia/Baku Asia/Yerevan Asia/Muscat Asia/Kabul Asia/Karachi Asia/Yekaterinburg Asia/Kolkata Asia/Katmandu Asia/Colombo Asia/Almaty Asia/Dhaka Asia/Rangoon Asia/Bangkok Asia/Krasnoyarsk Australia/Perth Asia/Taipei Asia/Singapore Asia/Irkutsk Asia/Chongqing Asia/Yakutsk Asia/Tokyo Asia/Seoul Australia/Adelaide Australia/Darwin Pacific/Guam Asia/Vladivostok Australia/Hobart Australia/Brisbane Australia/Canberra Asia/Magadan Pacific/Auckland Pacific/Fiji Pacific/Tongatapu


Accepted date formats are –

mm/dd/yyyy dd/mm/yy dd/mm/yyyy

You can set a password for the user.


The Id of the team you want to add the user to.

You can use the Get Teams API to retrieve the team Id.

Note: If this parameter is not passed, the user will be assigned to the root team in your account.


The Id of the work day template you want to assign to the user’s team.

Use the Get Teams API to retrieve the work day template Id.

Note: If passed, the work day template will be overridden for the user.


The Id of the holiday calendar you want to assign to the user’s team.

Use the Get Teams API to retrieve the holiday Id.

Note: If passed, the holiday calendar will be overridden for the user.


200 OK
Content-Type: application/json
    "Status": "Success",
    "Message": {
        "Id": "b3d4098f-fd15-11e8-ae3d-020714094d7e"

HTTP Response Codes

Code Description
200 OK

This is the status code for successful API call.

401 Unauthorized

The API call was made with invalid access credentials. Check your AccessKey and SecretKey.

400 Bad Request

The message body on the request is not as per API specification. Make sure that content type is set to “application/json” and the JSON body has correct attribute names and structure.

404 Not Found

The API could not be found. Please check the API signature.

429 Too Many Requests

API calls exceeded the limit of 25 in 5 second(s)

500 Internal Server Error

The API called failed. There could be many reasons for it. Check the exception message to get more details.

On this page

© 2022 by MarketXpander Services Pvt Ltd. All Rights Reserved.