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": "ace1d157-507f-4512-9cda-a8e236a15f10",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "139c8d75-30bf-494c-a06c-edb66fc7e9fd",
"db_language_id": "5d3ad72d-537c-45c7-a27a-e88ae466608d",
"db_title_id": "908fd368-47a2-4ee3-9bc7-805e104920eb",
"db_functionbis_id": "3515e11a-3a30-4422-9300-16894ab0f219",
"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-01-11T21:03:21.7751587+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>139c8d75-30bf-494c-a06c-edb66fc7e9fd</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>3515e11a-3a30-4422-9300-16894ab0f219</db_functionbis_id> <db_language_id>5d3ad72d-537c-45c7-a27a-e88ae466608d</db_language_id> <db_title_id>908fd368-47a2-4ee3-9bc7-805e104920eb</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>ace1d157-507f-4512-9cda-a8e236a15f10</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-01-11T21:03:21.775Z</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": "1c60cfb1-993b-4efc-910d-51b7469ab143",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "87966577-9410-4004-b8e8-816d96e0399f",
"db_language_id": "7912c814-9319-4c19-8094-ad8115cc3cde",
"db_title_id": "a829cb18-e39e-4934-a2ed-2cef666e18a6",
"db_functionbis_id": "0080ef09-bdd6-433c-a1aa-963c2b2cf7e5",
"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-01-11T21:03:21.8375012+00:00",
"contact_picture": "QEA="
}
application/xml, text/xml
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <archived>true</archived> <company_id>87966577-9410-4004-b8e8-816d96e0399f</company_id> <contact_picture>QEA=</contact_picture> <db_functionbis_id>0080ef09-bdd6-433c-a1aa-963c2b2cf7e5</db_functionbis_id> <db_language_id>7912c814-9319-4c19-8094-ad8115cc3cde</db_language_id> <db_title_id>a829cb18-e39e-4934-a2ed-2cef666e18a6</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>1c60cfb1-993b-4efc-910d-51b7469ab143</id> <lastname>sample string 3</lastname> <mobile>sample string 12</mobile> <modified_dateutc>2026-01-11T21:03:21.837Z</modified_dateutc> <notes>sample string 10</notes> <phone>sample string 11</phone> </contact>