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
{
"id": "fe57692a-c21a-40c6-b746-68f757f26691",
"firstname": "sample string 2",
"lastname": "sample string 3",
"company_id": "f4ba3479-998a-452b-bd76-8b6ca1e5ec63",
"company_code": "sample string 5",
"company": {
"id": "562f57ed-a2ed-4a73-ac65-2eb576a4e6b3",
"is_client": true,
"is_supplier": true,
"archived": true,
"name": "sample string 5",
"notes": "sample string 6",
"create_date": "2026-11-17T18:21:05.78233+00:00",
"sales_territory_id": "534dc4cc-1484-4c64-9a9e-151453900a78",
"sales_territory_code": "sample string 9",
"sales_territory": {
"id": "412fcf38-a96e-4d1e-a1aa-3af0bfcdc1bb",
"code": "sample string 2",
"description": "sample string 3",
"sales_organization_id": "427e4f94-0a94-42d4-b92d-431e1e0a54c1",
"sales_organization_code": "sample string 5",
"sales_organization": {
"id": "cc8a4035-195f-486a-8953-d5c6f717b89c",
"code": "sample string 2",
"name": "sample string 3",
"description": "sample string 4",
"db_country_id": "b82996c8-825b-4d69-87d5-04393cb1e6d4",
"db_currency_id": "9cd5e824-3dbc-4bba-85f9-f0055c50cb30",
"db_language_id": "f06f2541-0421-4760-a841-0a2ce944de9b",
"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-11-17T18:21:05.8016211+00:00"
},
"modified_dateutc": "2026-11-17T18:21:05.8016211+00:00"
},
"marketing_segment_id": "c11aa3f6-50a2-4346-842d-c68824082be9",
"marketing_segment_code": "sample string 11",
"sales_organization_id": "c2cc6281-e541-4fce-82e5-67ebe53b723a",
"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": "a2163038-448a-4e86-bc70-782d51d77ffc",
"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": "5f956547-8ff2-4fc4-ac8a-0a98322f6f71",
"db_country_code": "sample string 28",
"feelist_id": "1727cef0-63c1-4709-b359-caa0fb63a27d",
"feelist_reference_back_office": "sample string 30",
"feelist": {
"id": "6ae65e34-42d1-4c1a-a0d7-b829d63524fe",
"name": "sample string 2",
"description": "sample string 3",
"is_default": true,
"default_price": 1.0,
"sales_organization_id": "11d26c83-3035-476b-91a8-5f38b32f9f51",
"sales_organization_code": "sample string 6",
"reference_back_office": "sample string 7",
"modified_dateutc": "2026-11-17T18:21:05.8016211+00:00",
"db_currency_id": "a4f411ad-d9f7-40c7-a939-e49d3ea2a692",
"db_currency_code": "sample string 10"
},
"company_type_id": "9d8cd4f9-5196-44cf-acf6-38414b946a36",
"company_type_name": "sample string 32",
"company_type": {
"id": "91997de5-3499-4a73-a29d-41861099f524",
"name": "sample string 2",
"description": "sample string 3",
"sales_organization_id": "cfbefef7-ed7f-4a64-adbb-812f3e437f32",
"sales_organization_code": "sample string 5"
},
"db_language_id": "943897b4-a5ed-4194-a97e-31c414228b78",
"db_language_code": "sample string 34",
"code": "sample string 35",
"article_price_label_id": "0a5e0e3c-6abb-4f85-821d-d65fa525f76c",
"article_price_label_code": "sample string 37",
"db_payment_method_id": "f3a11463-33d4-4afb-95e8-d35c9b2b3c4c",
"db_payment_method_reference_back_office": "sample string 39",
"db_payment_methods": {
"id": "0e70bc5b-e272-4b95-b44d-e320fb47569c",
"name": "sample string 2",
"description": "sample string 3",
"reference_back_office": "sample string 4",
"activated": true,
"modified_dateutc": "2026-11-17T18:21:05.8016211+00:00"
},
"company_sector_id": "a33e2149-510b-481f-bf25-637478835395",
"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": "8de9355d-0213-4780-86c4-0193ad1ee716",
"service_manager_user_code": "sample string 52",
"finance_manager_user_id": "291ca9ad-61d1-4c36-9aff-35bcff3137dd",
"finance_manager_user_code": "sample string 54",
"account_manager_user_id": "34fa43e7-12a4-4dd7-b449-01c6aa718beb",
"account_manager_user_code": "sample string 56",
"company_status_id": "1977c3a9-1543-4470-bd66-bf813b88bb9a",
"invoice_email_to": "sample string 58",
"modified_dateutc": "2026-11-17T18:21:05.8016211+00:00",
"id2": 60
},
"db_language_id": "589e1a4e-407d-4476-952c-4aeb18f8ced8",
"db_language_code": "sample string 7",
"db_title_id": "97edba1c-2d22-4768-92cc-428aae6a8361",
"archived": true,
"functions": "sample string 10",
"e_login": "sample string 11",
"e_password": "sample string 12",
"notes": "sample string 13",
"birthdate": "2026-11-17T18:21:05.8016211+00:00",
"create_date": "2026-11-17T18:21:05.8016211+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-11-17T18:21:05.8016211+00:00"
}
Response Information
Resource Description :
IHttpActionResultNone.
Response Formats
application/json, text/json
Sample not available.