Creates a new user
Request Information
URI Parameters :
None.
Body Parameters :
user| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary Key |
globally unique identifier |
Required |
| db_language_id |
Foreign key of db_language |
globally unique identifier | |
| username |
Username of the user, normally his email address |
string |
Required Max length: 255 |
| firstname |
Firstname of the user |
string |
Max length: 255 |
| lastname |
Lastname of the user |
string |
Required Max length: 255 |
| code |
The Id/Ref of the back office. Used by Embedded entity |
string |
Max length: 50 |
| archived |
Archive the user if he is not valid anymore (user cannot be deleted) |
boolean | |
| disabled |
Disable temporaly the user (cannot log on) |
boolean | |
| emergency_contact |
HR : Person to contact in case of emergency (wife,husband) |
string |
Max length: 64 |
| bankaccount |
HR : Bank Account |
string |
Max length: 50 |
| social_security |
HR : Social Security Number |
string |
Max length: 50 |
| place_of_birth |
HR : place of birth |
string |
Max length: 255 |
| nationality |
HR : nationality of the user |
string |
Max length: 255 |
| functions |
HR : Functions of the user (Manager, Tech leader) |
string |
Max length: 255 |
| birthdate |
HR : Birthdate of the user |
date | |
| skype |
Skype name |
string |
Max length: 50 |
| notes |
Internal notes/remarks |
string | |
| sales_organization_id |
Main organization of the user |
globally unique identifier |
Optionally required : sales_organization_id, sales_organization_code or sales_organization must be provided |
| sales_organization |
Embedded entity "sales_organization" when adding/updating user |
sales_organization |
Optionally required : sales_organization_id, sales_organization_code or sales_organization must be provided |
| sales_organization_code |
Embedded entity "sales_organization" using ERP PK when adding/updating user |
string |
Optionally required : sales_organization_id, sales_organization_code or sales_organization must be provided |
| is_team_leader |
Specify if this user can be used as a team leader |
boolean | |
| team_leader_user_id |
Specify his team leader if this user is a team member |
globally unique identifier | |
|
Email of the user |
string |
Required Max length: 255 |
|
| phone |
Phone number of the user |
string |
Max length: 50 |
| fax |
Fax number of the user |
string |
Max length: 50 |
| mobile |
Mobile number of the user |
string |
Max length: 50 |
| private_email |
Private Email of the user |
string |
Max length: 250 |
| private_phone |
Private Phone number of the user |
string |
Max length: 50 |
| private_fax |
Private Fax number of the user |
string |
Max length: 50 |
| private_mobile |
Private Mobile number of the user |
string |
Max length: 50 |
| private_street |
Private Address:Street |
string |
Max length: 50 |
| private_street_number |
Private Address:Street Number |
string |
Max length: 50 |
| private_city |
Private Address:City |
string |
Max length: 50 |
| private_zip |
Private Address:Zip |
string |
Max length: 50 |
| private_db_country_id |
Private Address:Country |
globally unique identifier | |
| private_db_country_code |
Private Address:CountryCode entity using international code when adding/updating user |
string | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date | |
| allow_hero_app |
Specify if this user has priviliages to hero app |
boolean | |
| allow_sales_app |
Specify if this user has priviliages to salse app |
boolean | |
| allow_service_app |
Specify if this user has priviliages to service app |
boolean | |
| user_group_id |
Specify the user group that user belongs to |
globally unique identifier |
Request Formats :
application/json, text/json
{
"id": "a98a5afd-6c67-4ff8-85d3-b876dc8b044f",
"db_language_id": "a974ecbd-f0fc-4d35-aa47-78611817a3b4",
"username": "sample string 3",
"firstname": "sample string 4",
"lastname": "sample string 5",
"code": "sample string 6",
"archived": true,
"disabled": true,
"emergency_contact": "sample string 9",
"bankaccount": "sample string 10",
"social_security": "sample string 11",
"place_of_birth": "sample string 12",
"nationality": "sample string 13",
"functions": "sample string 14",
"birthdate": "2025-11-03T21:10:18.1405459+00:00",
"skype": "sample string 16",
"notes": "sample string 17",
"sales_organization_id": "11820d40-5f3a-4013-aa42-f83e2b83852e",
"sales_organization": {
"id": "af6785ad-8dcc-4d43-b39b-44f37e2cca57",
"code": "sample string 2",
"name": "sample string 3",
"description": "sample string 4",
"db_country_id": "f628fb55-700b-4884-8a30-49b4d38c2068",
"db_currency_id": "fcfc0141-02ce-4b91-80ad-a9f520185d4f",
"db_language_id": "7c9039e0-2b44-45bc-8ca1-4e6837ace783",
"accountancy_code": "sample string 8",
"archived": true,
"default_unit_of_measure_system_type": "sample string 10",
"street": "sample string 11",
"street2": "sample string 12",
"street_number": "sample string 13",
"zip": "sample string 14",
"city": "sample string 15",
"email": "sample string 16",
"phone": "sample string 17",
"fax": "sample string 18",
"url": "sample string 19",
"vat_reg_code": "sample string 20",
"modified_dateutc": "2025-11-03T21:10:18.1405459+00:00"
},
"sales_organization_code": "sample string 19",
"is_team_leader": true,
"team_leader_user_id": "b0f4654c-0f4f-4db7-90fe-327e67586e20",
"email": "sample string 22",
"phone": "sample string 23",
"fax": "sample string 24",
"mobile": "sample string 25",
"private_email": "sample string 26",
"private_phone": "sample string 27",
"private_fax": "sample string 28",
"private_mobile": "sample string 29",
"private_street": "sample string 30",
"private_street_number": "sample string 31",
"private_city": "sample string 32",
"private_zip": "sample string 33",
"private_db_country_id": "e69f5620-7111-476a-a36f-6d55d477563e",
"private_db_country_code": "sample string 35",
"modified_dateutc": "2025-11-03T21:10:18.1405459+00:00",
"allow_hero_app": true,
"allow_sales_app": true,
"allow_service_app": true,
"user_group_id": "4ac44bac-36b4-4323-b29c-f0e97f487708"
}
Response Information
Resource Description :
IHttpActionResultNone.
Response Formats
application/json, text/json
Sample not available.