Creates or updates a contact.

Request Information

URI Parameters :

None.

Body Parameters :

contact
NameDescriptionTypeAdditional 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
email

email

 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

Sample: 
{
  "id": "25f7c251-13b1-4231-a2a3-870407728137",
  "firstname": "sample string 2",
  "lastname": "sample string 3",
  "company_id": "971014a6-7ac0-49cd-8457-83c79690bb9a",
  "db_language_id": "9ac8aa2b-8d70-44e8-b96e-c3809203f3bb",
  "db_title_id": "e2104b1a-d842-4019-a79e-32fa7d5a310e",
  "db_functionbis_id": "3b7e6499-7be0-4010-8f84-653c3a3a7669",
  "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-09-16T09:23:34.7717009+00:00",
  "contact_picture": "QEA="
}

application/xml, text/xml

Sample: 
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <archived>true</archived>
  <company_id>971014a6-7ac0-49cd-8457-83c79690bb9a</company_id>
  <contact_picture>QEA=</contact_picture>
  <db_functionbis_id>3b7e6499-7be0-4010-8f84-653c3a3a7669</db_functionbis_id>
  <db_language_id>9ac8aa2b-8d70-44e8-b96e-c3809203f3bb</db_language_id>
  <db_title_id>e2104b1a-d842-4019-a79e-32fa7d5a310e</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>25f7c251-13b1-4231-a2a3-870407728137</id>
  <lastname>sample string 3</lastname>
  <mobile>sample string 12</mobile>
  <modified_dateutc>2026-09-16T09:23:34.771Z</modified_dateutc>
  <notes>sample string 10</notes>
  <phone>sample string 11</phone>
</contact>

Response Information

Resource Description :

IHttpActionResult containing the saved contact.

contact
NameDescriptionTypeAdditional 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
email

email

 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

Sample: 
{
  "id": "2430be3a-00d7-4888-9605-5c851251c4da",
  "firstname": "sample string 2",
  "lastname": "sample string 3",
  "company_id": "d8377474-2ef2-45d6-bae3-5d5993eca3b5",
  "db_language_id": "df602cbf-e2e3-4329-bf19-be8c218fdf13",
  "db_title_id": "86bf7773-9b3e-4f4b-a056-bf3d16003304",
  "db_functionbis_id": "e2825550-6734-4aa1-88d5-25be35bac668",
  "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-09-16T09:23:34.8016833+00:00",
  "contact_picture": "QEA="
}

application/xml, text/xml

Sample: 
<contact xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <archived>true</archived>
  <company_id>d8377474-2ef2-45d6-bae3-5d5993eca3b5</company_id>
  <contact_picture>QEA=</contact_picture>
  <db_functionbis_id>e2825550-6734-4aa1-88d5-25be35bac668</db_functionbis_id>
  <db_language_id>df602cbf-e2e3-4329-bf19-be8c218fdf13</db_language_id>
  <db_title_id>86bf7773-9b3e-4f4b-a056-bf3d16003304</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>2430be3a-00d7-4888-9605-5c851251c4da</id>
  <lastname>sample string 3</lastname>
  <mobile>sample string 12</mobile>
  <modified_dateutc>2026-09-16T09:23:34.801Z</modified_dateutc>
  <notes>sample string 10</notes>
  <phone>sample string 11</phone>
</contact>