Creates or updates a contact.
Request Information
URI Parameters :
None.
Body Parameters :
contact| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary key |
globally unique identifier |
Required |
| firstname |
Firstname of the contact |
string |
Max length: 50 |
| lastname |
Lastname of the contact. If you have one single field available for firstname+lastname then use Lastname |
string |
Required Max length: 50 |
| company_id |
company of the contact |
globally unique identifier | |
| db_language_id |
Language of the contact.If empty, will use the default on the system |
globally unique identifier | |
| db_title_id |
Foreign key of the contact's title/salutation (e.g. Mr, Mrs, Dr). |
globally unique identifier | |
| db_functionbis_id |
Foreign key of the contact's secondary function/role classification. |
globally unique identifier | |
| archived |
Archive this contact to not have it anymore on the search |
boolean | |
| functions |
Function of the contact (ServiceManager,...) |
string |
Max length: 64 |
| notes |
Free-text notes/remark about the contact. |
string | |
| phone |
Phone number of the contact |
string |
Max length: 255 |
| mobile |
Mobile number of the contact |
string |
Max length: 255 |
|
|
string |
Max length: 255 |
|
| e_login |
e_login |
string |
Max length: 50 |
| e_servicedesk |
e_servicedesk |
boolean | |
| e_new_password |
new_e_password |
string |
Max length: 50 |
| e_commerce |
Indicates this contact is allowed to place orders through the e-commerce portal. |
boolean | |
| e_document |
Indicates this contact is allowed to access shared documents through the e-Service portal. |
boolean | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date | |
| contact_picture |
Photo/picture of the contact, as raw image bytes. |
Collection of byte |
Request Formats :
application/json, text/json
{
"id": "a0f7f1a5-2185-44ca-979e-ffb7aaf1e87a",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "9fa4284e-87d4-4212-a85e-bab5bba01124",
"db_language_id": "3d8ce809-aec7-46b7-b2a0-b0dc3f40c8a1",
"db_title_id": "2196ace2-c6b4-4728-9709-6d3ec35436e8",
"db_functionbis_id": "7e87ab2e-7fd9-441e-8319-038f3ab07416",
"archived": true,
"functions": "sample string 9",
"notes": "sample string 10",
"phone": "sample string 11",
"mobile": "sample string 12",
"email": "sample string 13",
"e_login": "sample string 14",
"e_servicedesk": true,
"e_new_password": "sample string 16",
"e_commerce": true,
"e_document": true,
"modified_dateutc": "2026-11-12T14:28:12.5722007+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>9fa4284e-87d4-4212-a85e-bab5bba01124</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>7e87ab2e-7fd9-441e-8319-038f3ab07416</db_functionbis_id> <db_language_id>3d8ce809-aec7-46b7-b2a0-b0dc3f40c8a1</db_language_id> <db_title_id>2196ace2-c6b4-4728-9709-6d3ec35436e8</db_title_id> <e_commerce>true</e_commerce> <e_document>true</e_document> <e_login>sample string 14</e_login> <e_new_password>sample string 16</e_new_password> <e_servicedesk>true</e_servicedesk> <email>sample string 13</email> <firstname>sample string 2</firstname> <functions>sample string 9</functions> <id>a0f7f1a5-2185-44ca-979e-ffb7aaf1e87a</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-11-12T14:28:12.572Z</modified_dateutc> <notes>sample string 10</notes> <phone>sample string 11</phone> </contact>
Response Information
Resource Description :
IHttpActionResult containing the saved contact.
contact| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary key |
globally unique identifier |
Required |
| firstname |
Firstname of the contact |
string |
Max length: 50 |
| lastname |
Lastname of the contact. If you have one single field available for firstname+lastname then use Lastname |
string |
Required Max length: 50 |
| company_id |
company of the contact |
globally unique identifier | |
| db_language_id |
Language of the contact.If empty, will use the default on the system |
globally unique identifier | |
| db_title_id |
Foreign key of the contact's title/salutation (e.g. Mr, Mrs, Dr). |
globally unique identifier | |
| db_functionbis_id |
Foreign key of the contact's secondary function/role classification. |
globally unique identifier | |
| archived |
Archive this contact to not have it anymore on the search |
boolean | |
| functions |
Function of the contact (ServiceManager,...) |
string |
Max length: 64 |
| notes |
Free-text notes/remark about the contact. |
string | |
| phone |
Phone number of the contact |
string |
Max length: 255 |
| mobile |
Mobile number of the contact |
string |
Max length: 255 |
|
|
string |
Max length: 255 |
|
| e_login |
e_login |
string |
Max length: 50 |
| e_servicedesk |
e_servicedesk |
boolean | |
| e_new_password |
new_e_password |
string |
Max length: 50 |
| e_commerce |
Indicates this contact is allowed to place orders through the e-commerce portal. |
boolean | |
| e_document |
Indicates this contact is allowed to access shared documents through the e-Service portal. |
boolean | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date | |
| contact_picture |
Photo/picture of the contact, as raw image bytes. |
Collection of byte |
Response Formats
application/json, text/json
{
"id": "d7806356-aa70-47a4-b49b-441ffb357a6e",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "d996abe1-cb36-4760-8365-fc5b52e4a461",
"db_language_id": "c89f4a80-0e8c-4f3b-9db0-6aea952e0386",
"db_title_id": "c8738a8b-9237-40f7-8f94-be0a88174add",
"db_functionbis_id": "a5dbadbf-91fb-4342-8824-cc22ebc4c2f6",
"archived": true,
"functions": "sample string 9",
"notes": "sample string 10",
"phone": "sample string 11",
"mobile": "sample string 12",
"email": "sample string 13",
"e_login": "sample string 14",
"e_servicedesk": true,
"e_new_password": "sample string 16",
"e_commerce": true,
"e_document": true,
"modified_dateutc": "2026-11-12T14:28:12.5722007+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>d996abe1-cb36-4760-8365-fc5b52e4a461</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>a5dbadbf-91fb-4342-8824-cc22ebc4c2f6</db_functionbis_id> <db_language_id>c89f4a80-0e8c-4f3b-9db0-6aea952e0386</db_language_id> <db_title_id>c8738a8b-9237-40f7-8f94-be0a88174add</db_title_id> <e_commerce>true</e_commerce> <e_document>true</e_document> <e_login>sample string 14</e_login> <e_new_password>sample string 16</e_new_password> <e_servicedesk>true</e_servicedesk> <email>sample string 13</email> <firstname>sample string 2</firstname> <functions>sample string 9</functions> <id>d7806356-aa70-47a4-b49b-441ffb357a6e</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-11-12T14:28:12.572Z</modified_dateutc> <notes>sample string 10</notes> <phone>sample string 11</phone> </contact>