...
The payload’s properties are:
action | Value: Delete | string, Mandatory | ||
cid | The company ID of the person. You need to specify this value. | int, Mandatory | ||
pid, login, email | Use any of these three properties to uniquely identify the person to delete. The system will select in this order of priority: pid, then login, then email.
Examples:
| int?, string?, string? Mandatory | ||
data | An optional free-text information. It will be returned with the results for your convenience. | string, Optional |
Example:
| Code Block |
|---|
{
"action": "Delete",
"pid": 677,
"cid": 537,
"data": "just a test"
} |
...
The payload’s properties are:
action | Value: Create | string, Mandatory | |
cid | The company ID of the person. You need to specify this value. | int, Mandatory | |
The mandatory email. | string, Mandatory | ||
login | An optional login. Only specify if you want this user to be able to login. Note that no password will be assigned at this stage. | string?, Optional | |
fname | First name. | string, Mandatory | |
lname | Last name. | string, Mandatory | |
title | Optional title of person, such as “Dr.”, “Mrs.” etc. | string?, Optional | |
role | Optional role of the person, such as “Manager”. | string?, Optional | |
code | Optional name abbreviation. If not specified, the system automatically picks the initial letters of first and last name. “John Good” => “JG” | string?, Optional | |
phone | Optional phone number. | string?, Optional | |
phoneMobile | Optional mobile phone number. | string?, Optional | |
comments | Optional internal comments. | string?, Optional | |
timezone | Optional time zone. If not specified then the person inherits the time zone of the company to which he/she is attached (recommended). To enumerate available time zones see: settings/timezones/codes | string?, Optional | |
cfs | Optional person-level custom fields. It contains a collection of custom fields. Example:
|
|
You can reference custom fields by their numeric ID (see id) or their title (see t). The example above shows both approaches.
| object?, Optional | |
active | Optional boolean. If you want the person to be able to login, you should:
| bool?, Optional |
profile | Optional integer. Use to assign a specific user profile. If the new person has a login and is active, it is recommended to explicitly assign a user profile. If you do not do so then the system will automatically assign a user profile on your behalf. This will typically be the first profile in alphabetical order. See User profiles to enumerate available profiles. | int?, Optional |
data | An optional free-text information. It will be returned with the results for your convenience. | string?, Optional |
Creating a person without a login and the absolutely minimal required information:
...
Changing a person
The JSON properties are:
action | Value: Change | string, Mandatory | ||
cid | The company ID of the person. You need to specify this value. | int, Mandatory | ||
pid, login, email | Use any of these three properties to uniquely identify the person to delete. The system will select in this order of priority: pid, then login, then email.
Examples:
Note: If you would want to use a person custom field as the unique identifier then set the cfid field when updating, see persons/io/updates (POST) . Although we recommend to use the login or email as unique identifiers, nothing beats the flexibility of Wordbee! | int?, string?, string? Mandatory | ||
profile | To assign or change a user profile ID. This is only required for users that are assigned a login. | int?, Optional | ||
profileKeepExisting | If true then the user profile ID of an existing person will not be modified. This can be useful if the profile was changed inside Wordbee Translator, and an update request shall not tamper with such a change. | bool?, Optional | ||
* | Specify the properties that you want to change. These are those document further above for creating persons. | Optional | ||
data | An optional free-text information. It will be returned with the results for your convenience. | string?, Optional |
Updating the comments of a person. We select the person by its unique ID.
...
The big advantage over Create and Change is: You do not need to verify in advance if a person exists or not.
The JSON properties are:
action | Value: ChangeOrCreate | string, Mandatory |
cid | The company ID of the person. You need to specify this value. | int, Mandatory |
pid, login, email | Specify any one of the three identifiers below:
If the system cannot find back the person with the identifiers above, it will proceed with the creation of a new person. Note: If you would want to use a person custom field as the unique identifier then set the cfid field when updating, see persons/io/updates (POST) . Although we recommend to use the login or email as unique identifiers, nothing beats the flexibility of Wordbee! | int?, string?, string? Mandatory |
profile | To assign or change a user profile ID. This is only required for users that are assigned a login. | int?, Optional |
profileKeepExisting | If true then the user profile ID of an existing person will not be modified. This can be useful if the profile was changed inside Wordbee Translator, and an update request shall not tamper with such a change. | bool?, Optional |
* | Specify the other properties. Important: All properties that are mandatory when creating persons must be specified. | Some mandatory, Some optional |
data | An optional free-text information. It will be returned with the results for your convenience. | string?, Optional |
Update person or create if it does not yet exist:
...
This mode tells the system to simply disregard the request.
action | Value: Skip | string, Mandatory |
data | The company ID of the person. You need to specify this value. | int, Mandatory |
data | An optional free-text information. It will be returned with the results for your convenience. | string?, Optional |
Example:
| Code Block |
|---|
{
"action": "Skip",
"fname": "Andre",
"lname": "Lima",
"data": "disregard this record!"
} |
...