Creates a new 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": "27aedc10-677b-4657-91f9-76255acdb799",
  "firstname": "sample string 2",
  "lastname": "sample string 3",
  "company_id": "dcc478e7-e6b5-4b62-b2e1-77d95395b34b",
  "db_language_id": "ed439fa2-a6b7-4a01-b223-9f4e7824ee2a",
  "db_title_id": "e71b9692-9f13-4eab-9ef3-604ae29ce23b",
  "db_functionbis_id": "5f685592-af32-437e-b9cf-40b97f6f6dab",
  "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-16T10:13:08.8470465+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>dcc478e7-e6b5-4b62-b2e1-77d95395b34b</company_id>
  <contact_picture>QEA=</contact_picture>
  <db_functionbis_id>5f685592-af32-437e-b9cf-40b97f6f6dab</db_functionbis_id>
  <db_language_id>ed439fa2-a6b7-4a01-b223-9f4e7824ee2a</db_language_id>
  <db_title_id>e71b9692-9f13-4eab-9ef3-604ae29ce23b</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>27aedc10-677b-4657-91f9-76255acdb799</id>
  <lastname>sample string 3</lastname>
  <mobile>sample string 12</mobile>
  <modified_dateutc>2026-09-16T10:13:08.847Z</modified_dateutc>
  <notes>sample string 10</notes>
  <phone>sample string 11</phone>
</contact>

Response Information

Resource Description :

IHttpActionResult containing the created 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": "9c55e345-4cd6-40f5-88cc-02a6ed1d13a2",
  "firstname": "sample string 2",
  "lastname": "sample string 3",
  "company_id": "71fed8d2-de6b-4dcc-9b9d-b23448319c92",
  "db_language_id": "7c1c8c88-e95b-4f96-aa6d-c5fc536abac8",
  "db_title_id": "960520ca-465d-46ff-bf84-cbb9f6501dc0",
  "db_functionbis_id": "a84de9b9-f753-4aab-827b-b395d4b2d77c",
  "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-16T10:13:08.8470465+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>71fed8d2-de6b-4dcc-9b9d-b23448319c92</company_id>
  <contact_picture>QEA=</contact_picture>
  <db_functionbis_id>a84de9b9-f753-4aab-827b-b395d4b2d77c</db_functionbis_id>
  <db_language_id>7c1c8c88-e95b-4f96-aa6d-c5fc536abac8</db_language_id>
  <db_title_id>960520ca-465d-46ff-bf84-cbb9f6501dc0</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>9c55e345-4cd6-40f5-88cc-02a6ed1d13a2</id>
  <lastname>sample string 3</lastname>
  <mobile>sample string 12</mobile>
  <modified_dateutc>2026-09-16T10:13:08.847Z</modified_dateutc>
  <notes>sample string 10</notes>
  <phone>sample string 11</phone>
</contact>