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.


You can use –

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

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

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