Creates a new contact object
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 |
Optionally required : company_id,company_code or company must be provided |
| company_code |
Embedded entity "company" using ERP PK when adding/updating contact |
string |
Optionally required : company_id,company_code or company must be provided |
| company |
Embedded entity "company" when adding/updating contact |
company |
Optionally required : company_id,company_code or company must be provided |
| db_language_id |
Language of the contact.If empty, will use the default on the system |
globally unique identifier | |
| db_language_code |
Language code entity using international isocode when adding/updating contact |
string | |
| db_title_id |
The title of the contact |
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 |
| e_login |
Login of the contact (if have access to ServiceDesk) |
string |
Max length: 50 |
| e_password |
Password in clear text of the contact (if have access to ServiceDesk) |
string |
Max length: 50 |
| notes |
Notes/Remark field |
string | |
| birthdate |
Birthday date |
date | |
| create_date |
Creation date+time |
date | |
| phone |
Phone number of the contact |
string |
Max length: 50 |
| mobile |
a number of the contact |
string |
Max length: 50 |
|
|
string |
Max length: 250 |
|
| skype |
skype |
string |
Max length: 250 |
| private_phone |
Private phone number of the contact |
string |
Max length: 50 |
| private_mobile |
Private mobile number of the contact |
string |
Max length: 50 |
| private_email |
Private email |
string |
Max length: 250 |
| reference_back_office |
Field used for Embedded entity (store there your ERP PK) |
string |
Max length: 50 |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date |
Request Formats :
application/json, text/json
Sample:
{
"id": "37d2a957-e84a-4956-9ad0-6f7d964a2af9",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "f6c615b4-c73b-41db-a91f-25e3ff35df65",
"company_code": "sample string 5",
"company": {
"id": "cc8ee1e0-7b0e-4173-93ff-2b44526e2d40",
"is_client": true,
"is_supplier": true,
"archived": true,
"name": "sample string 5",
"notes": "sample string 6",
"create_date": "2026-09-28T21:21:27.4466458+00:00",
"sales_territory_id": "c7643183-95ba-4956-988b-d0a3a2b6d253",
"sales_territory_code": "sample string 9",
"sales_territory": {
"id": "ef293772-0898-4995-ba7c-194cacddb060",
"code": "sample string 2",
"description": "sample string 3",
"sales_organization_id": "65d7aadf-7a5b-4514-bde2-6ae7949462f9",
"sales_organization_code": "sample string 5",
"sales_organization": {
"id": "dc930825-fc07-40f3-bf1a-e856b998dfef",
"code": "sample string 2",
"name": "sample string 3",
"description": "sample string 4",
"db_country_id": "37498624-19ff-43e1-8d79-7475026e39c1",
"db_currency_id": "cc2d21a1-1ac2-4fe6-8989-31576a6e7157",
"db_language_id": "cf2b428d-e89c-4c0e-9997-338606e8ac72",
"accountancy_code": "sample string 8",
"archived": true,
"default_unit_of_measure_system_type": "sample string 10",
"street": "sample string 11",
"street2": "sample string 12",
"street_number": "sample string 13",
"zip": "sample string 14",
"city": "sample string 15",
"email": "sample string 16",
"phone": "sample string 17",
"fax": "sample string 18",
"url": "sample string 19",
"vat_reg_code": "sample string 20",
"modified_dateutc": "2026-09-28T21:21:27.4466458+00:00"
},
"modified_dateutc": "2026-09-28T21:21:27.4466458+00:00"
},
"marketing_segment_id": "24261cf2-7cea-489d-a5c6-4b4e99467a4c",
"marketing_segment_code": "sample string 11",
"sales_organization_id": "5cb8d8b0-9265-4b06-87ad-6b99060afaca",
"sales_organization_code": "sample string 13",
"company_sales_status_code": "sample string 14",
"vat_reg_code": "sample string 15",
"is_working_address": true,
"parent_id": "c43bae36-b8d0-4128-93d1-fc188626565f",
"parent_company_code": "sample string 18",
"phone": "sample string 19",
"fax": "sample string 20",
"url": "sample string 21",
"email": "sample string 22",
"street": "sample string 23",
"street_number": "sample string 24",
"city": "sample string 25",
"zip": "sample string 26",
"db_country_id": "ea13cd85-7403-4ad6-9168-b134ebb25bb9",
"db_country_code": "sample string 28",
"feelist_id": "9b2fce1f-80b4-43c4-96cd-f2cd1c17d945",
"feelist_reference_back_office": "sample string 30",
"feelist": {
"id": "18ad1666-1b5e-43bf-a09f-0a8618ed66f8",
"name": "sample string 2",
"description": "sample string 3",
"is_default": true,
"default_price": 1.0,
"sales_organization_id": "17da0174-0b60-469b-b374-412dee24192b",
"sales_organization_code": "sample string 6",
"reference_back_office": "sample string 7",
"modified_dateutc": "2026-09-28T21:21:27.4466458+00:00",
"db_currency_id": "2ac4d975-bbcf-4dbf-bc96-310da2009a42",
"db_currency_code": "sample string 10"
},
"company_type_id": "5e149b1a-64cb-44f5-b202-df5f619a473e",
"company_type_name": "sample string 32",
"company_type": {
"id": "2604c7ac-4c5f-4689-ac6b-3539cba0a5ba",
"name": "sample string 2",
"description": "sample string 3",
"sales_organization_id": "2700f394-7a92-45d9-9e4f-a85fd89f3269",
"sales_organization_code": "sample string 5"
},
"db_language_id": "52910001-b1b1-4f89-8943-d2d2664dc39a",
"db_language_code": "sample string 34",
"code": "sample string 35",
"article_price_label_id": "a1fcf824-404a-4b67-b503-8ac29bcc5643",
"article_price_label_code": "sample string 37",
"db_payment_method_id": "c234e566-ab72-49a5-b0a4-f5462756a994",
"db_payment_method_reference_back_office": "sample string 39",
"db_payment_methods": {
"id": "09a98bf6-2a74-4f6b-904e-8b2c3a040b6b",
"name": "sample string 2",
"description": "sample string 3",
"reference_back_office": "sample string 4",
"activated": true,
"modified_dateutc": "2026-09-28T21:21:27.4466458+00:00"
},
"company_sector_id": "b9ed7371-2d0e-427b-86f3-77e0312ae4ac",
"company_sector_code": "sample string 41",
"is_lead": true,
"is_subcontractor": true,
"latitude": 1.0,
"longitude": 1.0,
"street2": "sample string 44",
"bic_code": "sample string 45",
"specialities": "sample string 46",
"register_number": "sample string 47",
"register_city": "sample string 48",
"bankaccount": "sample string 49",
"mobile": "sample string 50",
"service_manager_user_id": "6ac738ee-bb14-45ca-9d09-41182c8e6b55",
"service_manager_user_code": "sample string 52",
"finance_manager_user_id": "84ec7322-c5f5-4c67-9b84-6b36354b79cb",
"finance_manager_user_code": "sample string 54",
"account_manager_user_id": "f28fde7d-a20a-44b8-a614-af348c7d930f",
"account_manager_user_code": "sample string 56",
"company_status_id": "0e49cb5b-f979-4014-9ba8-27adcb2bcade",
"invoice_email_to": "sample string 58",
"modified_dateutc": "2026-09-28T21:21:27.4466458+00:00",
"id2": 60
},
"db_language_id": "311c0e89-a08a-44bd-9d77-5386118381d5",
"db_language_code": "sample string 7",
"db_title_id": "041a2bfc-fea0-44c2-9428-04d2883c9d79",
"archived": true,
"functions": "sample string 10",
"e_login": "sample string 11",
"e_password": "sample string 12",
"notes": "sample string 13",
"birthdate": "2026-09-28T21:21:27.4466458+00:00",
"create_date": "2026-09-28T21:21:27.4466458+00:00",
"phone": "sample string 16",
"mobile": "sample string 17",
"email": "sample string 18",
"skype": "sample string 19",
"private_phone": "sample string 20",
"private_mobile": "sample string 21",
"private_email": "sample string 22",
"reference_back_office": "sample string 23",
"modified_dateutc": "2026-09-28T21:21:27.4466458+00:00"
}
Response Information
Resource Description :
IHttpActionResultNone.
Response Formats
application/json, text/json
Sample:
Sample not available.