Add/update 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 | globally unique identifier | ||
| db_functionbis_id | 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 | 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 | boolean | ||
| e_document | boolean | ||
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date | |
| contact_picture | Collection of byte |
Request Formats :
application/json, text/json
{
"id": "ffe3b814-3000-4112-b2dd-326a8d23989e",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "3c34bd80-149a-4258-bccb-6a7f466cb0ca",
"db_language_id": "3c662749-ad13-412a-a658-0a6d07c22c67",
"db_title_id": "c4f937f4-aa68-4b80-b1a4-8ab9eca9d8eb",
"db_functionbis_id": "5b815a94-7d3b-4515-bdaf-0c4775c0672c",
"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-03-07T13:16:28.7210635+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>3c34bd80-149a-4258-bccb-6a7f466cb0ca</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>5b815a94-7d3b-4515-bdaf-0c4775c0672c</db_functionbis_id> <db_language_id>3c662749-ad13-412a-a658-0a6d07c22c67</db_language_id> <db_title_id>c4f937f4-aa68-4b80-b1a4-8ab9eca9d8eb</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>ffe3b814-3000-4112-b2dd-326a8d23989e</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-03-07T13:16:28.721Z</modified_dateutc> <notes>sample string 10</notes> <phone>sample string 11</phone> </contact>
Response Information
Resource Description :
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 | globally unique identifier | ||
| db_functionbis_id | 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 | 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 | boolean | ||
| e_document | boolean | ||
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date | |
| contact_picture | Collection of byte |
Response Formats
application/json, text/json
{
"id": "b2ebccb8-d008-43cd-b380-5937faae2bbd",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "3ce10400-b5ff-417b-af4e-eb6b81301568",
"db_language_id": "17383d71-e71a-4b6e-bbb8-e2ed1db3eb51",
"db_title_id": "9cd8d8d7-9658-4f34-a9c8-c034a98db006",
"db_functionbis_id": "03f1fe89-28e6-4f2f-830b-bb19e3f25542",
"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-03-07T13:16:28.7696756+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>3ce10400-b5ff-417b-af4e-eb6b81301568</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>03f1fe89-28e6-4f2f-830b-bb19e3f25542</db_functionbis_id> <db_language_id>17383d71-e71a-4b6e-bbb8-e2ed1db3eb51</db_language_id> <db_title_id>9cd8d8d7-9658-4f34-a9c8-c034a98db006</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>b2ebccb8-d008-43cd-b380-5937faae2bbd</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-03-07T13:16:28.769Z</modified_dateutc> <notes>sample string 10</notes> <phone>sample string 11</phone> </contact>