This method lets you add users, with or without login, to a client, a supplier or inhouse staff. In order to create an in-house user, specify the platform company id.
URL
(PUT) companies/{companyid}/persons
PARAMETERS
|
token |
The token obtained on connection |
Required |
|
companyid |
The company id of the person to add |
Required |
|
data |
A json containing the person information (see below) |
Required |
JSON format of "data" parameter
|
LastName |
The last name of the person |
Required |
|
FirstName |
The first name of the person |
Required |
|
|
The email address of the person. This must be a valid email address or the API will return an error. |
Required |
|
Login |
The login to connect. Use for example "John.Hollow" or "mylogin123". The minimum length of logins is 8 characters. |
Optional |
|
Password |
The password to connect. The password must comply with the password policy settings (see "Settings" > "Advanced security" in Wordbee Translator. |
Optional |
|
UserProfileId |
The profile id of the person. See API call to enumerate profiles. Note that you cannot create a person with the Administrator profile and that you cannot delete the Administrator. |
Optional |
|
IsActive |
Activate or deactivate account. An inactive account cannot login. Boolean value. To activate a person you need to specify login, password and profile id as well. Default value if not set: false |
Optional |
|
PersonCode |
The person code. Default value: If not set, then preset with the first letter of the first name and the first letter of the last name. |
Optional |
|
Title |
The person title |
Optional |
|
Role |
The person role |
Optional |
|
Phone |
The person phone number |
Optional |
|
PhoneMobile |
The person mobile phone number |
Optional |
|
Comments |
Internal comments on person |
Optional |
|
Labels |
Set a label: "labels": [ { "id": 10, "value": 1 }, … ] Clear a label: "labels": [ { "id": 10, "value": null }, … ] |
Optional |
Just set the fields that you want to give a value in the JSON.
If you want to create a login for this person, Login, Password and UserProfileId must all be set.
You can get a list of the profiles using the following api call: master/persons/profiles?token={tokenid}
License checks: When enabling an account, the system verifies that a user account license is still available. If this is not the case, the API returns an HTTP error code.
Here is a sample to create a person with a login (enabled). Json data parameter:
{
"LastName":"Collignon",
"FirstName":"Adrien",
"Email":"acollignon@wordbee.com",
"Login":"Adrien.Login",
"Password":"password1",
"UserProfileId":8,
"IsActive":true
}
Create a person without a login. Json data parameter:
{
"LastName":"Collignon",
"FirstName":"Adrien",
"Email":"acollignon@wordbee.com"
}
RESULTS
The id of the created person. In case of invalid parameters an HTTP error code is returned.