Add User Data

Add User Data

Purpose

To add new User/location to your organization.

Request URL

https://live.membroz.com/api/users

Request Method

POST
Note
  • Send authkey in https header
  • You can add only one user per POST request.
  • You must use only Field API names in the input. You can obtain the field API names from Fields metadata API
  • Enterprise customer can replace domain name with their hosting Url. for example https://app.xyz.com/api/users
  • API will return inserted user data in JSON format or error message.

Request JSON

Attribute Data Type Mandatory Description
username text yes user/location/company name
currency text
country text
timezone text
city text
companyphone text
contactperson text

Sample Request

curl --location --request POST 'https://live.membroz.com/api/users' \
--header 'authkey:  XXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw ' {
        
        "isfirstlogin": false,
        "status": "active",
        "username": "xyz12345@gmail.com",
        "password": "123",
        "role": "5dd37f876c98a22df08b9509",
        "anroiddevices": [
            {
                "_id": "5ebd0831a6f1722dbd1a604c",
                "deviceid": "2599db9b1c4af598"
            },
            {
                "_id": "5ed242a4fa2150bfa757d30a",
                "deviceid": "f7185abc7e9e2480"
            },
            {
                "_id": "5f0ea9703a10b8350917e075",
                "deviceid": "57c3fb83d15813a2"
            },
            {
                "_id": "5f215bba9179ab5f9bee1245",
                "deviceid": "8310b78d251fd4de"
            },
            {
                "_id": "5f215ceb9179ab5f9bee1246",
                "deviceid": "e875606486385cb3"
            }
        ],
        "iosdevices": [],
        "designationid":"5ed0b4ad1b4f7c7b2677f62f",
        "property": {
            "fullname": "Membroz Gym",
            "mobile_number": null,
            "email": "xyz12345@gmail.com",
            "country": "United States",
            "membrozid": "5e954c7b9df11624f81e7859",
            "isadmin": false
        },
        "createdAt": "2020-04-14T05:39:07.850Z",
        "updatedAt": "2020-08-24T12:40:01.713Z",
        "fullname": "Membroz Gym ",
        "namenumber": "Membroz Gym "
    }'
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, " {\r\n        \r\n        \"isfirstlogin\": false,\r\n        \"status\": \"active\",\r\n        \"username\": \"xyz12345@gmail.com\",\r\n        \"password\": \"123\",\r\n        \"role\": \"5dd37f876c98a22df08b9509\",\r\n        \"anroiddevices\": [\r\n            {\r\n                \"_id\": \"5ebd0831a6f1722dbd1a604c\",\r\n                \"deviceid\": \"2599db9b1c4af598\"\r\n            },\r\n            {\r\n                \"_id\": \"5ed242a4fa2150bfa757d30a\",\r\n                \"deviceid\": \"f7185abc7e9e2480\"\r\n            },\r\n            {\r\n                \"_id\": \"5f0ea9703a10b8350917e075\",\r\n                \"deviceid\": \"57c3fb83d15813a2\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215bba9179ab5f9bee1245\",\r\n                \"deviceid\": \"8310b78d251fd4de\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215ceb9179ab5f9bee1246\",\r\n                \"deviceid\": \"e875606486385cb3\"\r\n            }\r\n        ],\r\n        \"iosdevices\": [],\r\n        \"designationid\":\"5ed0b4ad1b4f7c7b2677f62f\",\r\n        \"property\": {\r\n            \"fullname\": \"Membroz Gym\",\r\n            \"mobile_number\": null,\r\n            \"email\": \"xyz12345@gmail.com\",\r\n            \"country\": \"United States\",\r\n            \"membrozid\": \"5e954c7b9df11624f81e7859\",\r\n            \"isadmin\": false\r\n        },\r\n        \"createdAt\": \"2020-04-14T05:39:07.850Z\",\r\n        \"updatedAt\": \"2020-08-24T12:40:01.713Z\",\r\n        \"fullname\": \"Membroz Gym \",\r\n        \"namenumber\": \"Membroz Gym \"\r\n    }");
Request request = new Request.Builder()
  .url("https://live.membroz.com/api/users")
  .method("POST", body)
  .addHeader("authkey", "  XXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();
 "https://live.membroz.com/api/users",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>" {\r\n        \r\n        \"isfirstlogin\": false,\r\n        \"status\": \"active\",\r\n        \"username\": \"xyz12345@gmail.com\",\r\n        \"password\": \"123\",\r\n        \"role\": \"5dd37f876c98a22df08b9509\",\r\n        \"anroiddevices\": [\r\n            {\r\n                \"_id\": \"5ebd0831a6f1722dbd1a604c\",\r\n                \"deviceid\": \"2599db9b1c4af598\"\r\n            },\r\n            {\r\n                \"_id\": \"5ed242a4fa2150bfa757d30a\",\r\n                \"deviceid\": \"f7185abc7e9e2480\"\r\n            },\r\n            {\r\n                \"_id\": \"5f0ea9703a10b8350917e075\",\r\n                \"deviceid\": \"57c3fb83d15813a2\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215bba9179ab5f9bee1245\",\r\n                \"deviceid\": \"8310b78d251fd4de\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215ceb9179ab5f9bee1246\",\r\n                \"deviceid\": \"e875606486385cb3\"\r\n            }\r\n        ],\r\n        \"iosdevices\": [],\r\n        \"designationid\":\"5ed0b4ad1b4f7c7b2677f62f\",\r\n        \"property\": {\r\n            \"fullname\": \"Membroz Gym\",\r\n            \"mobile_number\": null,\r\n            \"email\": \"xyz12345@gmail.com\",\r\n            \"country\": \"United States\",\r\n            \"membrozid\": \"5e954c7b9df11624f81e7859\",\r\n            \"isadmin\": false\r\n        },\r\n        \"createdAt\": \"2020-04-14T05:39:07.850Z\",\r\n        \"updatedAt\": \"2020-08-24T12:40:01.713Z\",\r\n        \"fullname\": \"Membroz Gym \",\r\n        \"namenumber\": \"Membroz Gym \"\r\n    }",
  CURLOPT_HTTPHEADER => array(
    "authkey:   XXXXXXXXXX",
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "https://live.membroz.com/api/users"

payload = " {\r\n        \r\n        \"isfirstlogin\": false,\r\n        \"status\": \"active\",\r\n        \"username\": \"xyz12345@gmail.com\",\r\n        \"password\": \"123\",\r\n        \"role\": \"5dd37f876c98a22df08b9509\",\r\n        \"anroiddevices\": [\r\n            {\r\n                \"_id\": \"5ebd0831a6f1722dbd1a604c\",\r\n                \"deviceid\": \"2599db9b1c4af598\"\r\n            },\r\n            {\r\n                \"_id\": \"5ed242a4fa2150bfa757d30a\",\r\n                \"deviceid\": \"f7185abc7e9e2480\"\r\n            },\r\n            {\r\n                \"_id\": \"5f0ea9703a10b8350917e075\",\r\n                \"deviceid\": \"57c3fb83d15813a2\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215bba9179ab5f9bee1245\",\r\n                \"deviceid\": \"8310b78d251fd4de\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215ceb9179ab5f9bee1246\",\r\n                \"deviceid\": \"e875606486385cb3\"\r\n            }\r\n        ],\r\n        \"iosdevices\": [],\r\n        \"designationid\":\"5ed0b4ad1b4f7c7b2677f62f\",\r\n        \"property\": {\r\n            \"fullname\": \"Membroz Gym\",\r\n            \"mobile_number\": null,\r\n            \"email\": \"xyz12345@gmail.com\",\r\n            \"country\": \"United States\",\r\n            \"membrozid\": \"5e954c7b9df11624f81e7859\",\r\n            \"isadmin\": false\r\n        },\r\n        \"createdAt\": \"2020-04-14T05:39:07.850Z\",\r\n        \"updatedAt\": \"2020-08-24T12:40:01.713Z\",\r\n        \"fullname\": \"Membroz Gym \",\r\n        \"namenumber\": \"Membroz Gym \"\r\n    }"
headers = {
  'authkey': '  XXXXXXXXXX',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
require "uri"
require "net/http"

url = URI("https://live.membroz.com/api/users")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authkey"] = "  XXXXXXXXXX"
request["Content-Type"] = "application/json"
request.body = " {\r\n        \r\n        \"isfirstlogin\": false,\r\n        \"status\": \"active\",\r\n        \"username\": \"xyz12345@gmail.com\",\r\n        \"password\": \"123\",\r\n        \"role\": \"5dd37f876c98a22df08b9509\",\r\n        \"anroiddevices\": [\r\n            {\r\n                \"_id\": \"5ebd0831a6f1722dbd1a604c\",\r\n                \"deviceid\": \"2599db9b1c4af598\"\r\n            },\r\n            {\r\n                \"_id\": \"5ed242a4fa2150bfa757d30a\",\r\n                \"deviceid\": \"f7185abc7e9e2480\"\r\n            },\r\n            {\r\n                \"_id\": \"5f0ea9703a10b8350917e075\",\r\n                \"deviceid\": \"57c3fb83d15813a2\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215bba9179ab5f9bee1245\",\r\n                \"deviceid\": \"8310b78d251fd4de\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215ceb9179ab5f9bee1246\",\r\n                \"deviceid\": \"e875606486385cb3\"\r\n            }\r\n        ],\r\n        \"iosdevices\": [],\r\n        \"designationid\":\"5ed0b4ad1b4f7c7b2677f62f\",\r\n        \"property\": {\r\n            \"fullname\": \"Membroz Gym\",\r\n            \"mobile_number\": null,\r\n            \"email\": \"xyz12345@gmail.com\",\r\n            \"country\": \"United States\",\r\n            \"membrozid\": \"5e954c7b9df11624f81e7859\",\r\n            \"isadmin\": false\r\n        },\r\n        \"createdAt\": \"2020-04-14T05:39:07.850Z\",\r\n        \"updatedAt\": \"2020-08-24T12:40:01.713Z\",\r\n        \"fullname\": \"Membroz Gym \",\r\n        \"namenumber\": \"Membroz Gym \"\r\n    }"

response = https.request(request)
puts response.read_body
var client = new RestClient("https://live.membroz.com/api/users");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("authkey", "  XXXXXXXXXX");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", " {\r\n        \r\n        \"isfirstlogin\": false,\r\n        \"status\": \"active\",\r\n        \"username\": \"xyz12345@gmail.com\",\r\n        \"password\": \"123\",\r\n        \"role\": \"5dd37f876c98a22df08b9509\",\r\n        \"anroiddevices\": [\r\n            {\r\n                \"_id\": \"5ebd0831a6f1722dbd1a604c\",\r\n                \"deviceid\": \"2599db9b1c4af598\"\r\n            },\r\n            {\r\n                \"_id\": \"5ed242a4fa2150bfa757d30a\",\r\n                \"deviceid\": \"f7185abc7e9e2480\"\r\n            },\r\n            {\r\n                \"_id\": \"5f0ea9703a10b8350917e075\",\r\n                \"deviceid\": \"57c3fb83d15813a2\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215bba9179ab5f9bee1245\",\r\n                \"deviceid\": \"8310b78d251fd4de\"\r\n            },\r\n            {\r\n                \"_id\": \"5f215ceb9179ab5f9bee1246\",\r\n                \"deviceid\": \"e875606486385cb3\"\r\n            }\r\n        ],\r\n        \"iosdevices\": [],\r\n        \"designationid\":\"5ed0b4ad1b4f7c7b2677f62f\",\r\n        \"property\": {\r\n            \"fullname\": \"Membroz Gym\",\r\n            \"mobile_number\": null,\r\n            \"email\": \"xyz12345@gmail.com\",\r\n            \"country\": \"United States\",\r\n            \"membrozid\": \"5e954c7b9df11624f81e7859\",\r\n            \"isadmin\": false\r\n        },\r\n        \"createdAt\": \"2020-04-14T05:39:07.850Z\",\r\n        \"updatedAt\": \"2020-08-24T12:40:01.713Z\",\r\n        \"fullname\": \"Membroz Gym \",\r\n        \"namenumber\": \"Membroz Gym \"\r\n    }",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Possible Errors

HTTP Status Error Code Message Reason
permission denied 403 You do not have permission

Sample Response

{
    "isfirstlogin": true,
    "status": "active",
    "_id": "5f6c6888c97e67698f668762",
    "username": "xyz12345@gmail.com",
    "password": "$2a$10$CzSRGp2ZYZ69aLuyyFGOG.o6LIQkgEJjHml/zxSWrCDom2F.jy6t2",
    "role": "5dd37f876c98a22df08b9509",
    "anroiddevices": [
        {
            "_id": "5ebd0831a6f1722dbd1a604c",
            "deviceid": "2599db9b1c4af598"
        },
        {
            "_id": "5ed242a4fa2150bfa757d30a",
            "deviceid": "f7185abc7e9e2480"
        },
     
    ],
    "iosdevices": [],
    "designationid": "5ed0b4ad1b4f7c7b2677f62f",
    "branchid": "5e954c7b9df11624f81e7859",
    "salarycomponent": [],
    "addedby": "5e954c7b9df11624f81e785b",
    "property": {
        "fullname": "Membroz Gym",
        "mobile_number": null,
        "email": "xyz12345@gmail.com",
        "country": "United States",
        "membrozid": "5e954c7b9df11624f81e7859",
        "isadmin": false
    },
    "createdAt": "2020-09-24T09:36:08.204Z",
    "updatedAt": "2020-09-24T09:36:08.204Z",
    "fullname": "Membroz Gym ",
    "namenumber": "Membroz Gym ",
    "updatedby": "5e954c7b9df11624f81e785b"
}