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": "860320d4-fda3-4b1b-88df-bbf5652a4022",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "bad9d8c6-a890-4c39-8075-65a2dca89158",
"db_language_id": "4be5ba1b-95c7-4b5c-b9f3-4afb3f9d5dd3",
"db_title_id": "d4d4d360-4627-408d-bf9d-3e238b725e9f",
"db_functionbis_id": "c47329ec-9a5b-4c2c-a217-3af77769d2cf",
"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-06-16T22:30:57.6027836+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>bad9d8c6-a890-4c39-8075-65a2dca89158</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>c47329ec-9a5b-4c2c-a217-3af77769d2cf</db_functionbis_id> <db_language_id>4be5ba1b-95c7-4b5c-b9f3-4afb3f9d5dd3</db_language_id> <db_title_id>d4d4d360-4627-408d-bf9d-3e238b725e9f</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>860320d4-fda3-4b1b-88df-bbf5652a4022</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-06-16T22:30:57.602Z</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": "85b6c623-2113-47e2-b232-a2375d32c37f",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "01305cb8-f9f5-4a94-8f34-818a6771da7f",
"db_language_id": "5164dc6c-af6b-43a0-a000-5c135bb78bfb",
"db_title_id": "f9dbeeef-68ad-4fac-afb6-fd4f58b944f2",
"db_functionbis_id": "61e839a1-6fda-498d-b58b-649cd906e2b9",
"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-06-16T22:30:57.6027836+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>01305cb8-f9f5-4a94-8f34-818a6771da7f</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>61e839a1-6fda-498d-b58b-649cd906e2b9</db_functionbis_id> <db_language_id>5164dc6c-af6b-43a0-a000-5c135bb78bfb</db_language_id> <db_title_id>f9dbeeef-68ad-4fac-afb6-fd4f58b944f2</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>85b6c623-2113-47e2-b232-a2375d32c37f</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-06-16T22:30:57.602Z</modified_dateutc> <notes>sample string 10</notes> <phone>sample string 11</phone> </contact>