POST v1/{organizationId}/contacts

Add a new contact to the organization

Request Information

URI Parameters

NameDescriptionTypeAdditional information
organizationId

string

None.

Body Parameters

Content of the new contact

CreateContact
NameDescriptionTypeAdditional information
ExternalReference

Your external id This can be used for ID'ing in external apps/services e.g. a web shop. The maximum length is 128 characters

string

String length: inclusive between 0 and 128

Name

Name of the contact person or the company name

string

Required

Street

Street name

string

None.

ZipCode

Zip code

string

None.

City

City

string

None.

CountryKey

Country key Two character string e.g. DK for Denmark, DE for Germany or SE for Sweden

string

Required

Phone

Phone number

string

None.

Email

Email address

string

None.

Webpage

Webpage address

string

None.

AttPerson

Name of the att. person in cases here the contact is a company. If IsPerson this should be NULL.

string

None.

VatNumber

VAT number. If IsPerson this should be NULL.

string

None.

EanNumber

EAN number. This number is used for digital invoicing. If IsPerson this should be NULL.

string

None.

PaymentConditionType

Type of the payment condition for the contact. Netto, NettoCash or CurrentMonthOut. If NettoCash, then PaymentConditionNumberOfDays should be null. Defaults to Netto.

string

None.

PaymentConditionNumberOfDays

Number of days for payment for the contact. E.g. that the contact has 7 days until payment has to be made. This field depends on PaymentConditionType. If left empty, defaults to 8 for all other payment types then NettoCash.

integer

None.

IsPerson

Boolean to indicate whether the contact is a private person or a company. If true, the contact is a person.

boolean

Required

Sample:
{
  "ExternalReference": "Fx. WebShopID:42",
  "Name": "John Doe",
  "Street": "Main road 42",
  "ZipCode": "2100",
  "City": "Copenhagen",
  "CountryKey": "DK",
  "Phone": "+45 99 99 99 99",
  "Email": "test@test.com",
  "Webpage": "test.com",
  "AttPerson": "Donald Duck",
  "VatNumber": "12345674",
  "EanNumber": "1111000022223",
  "PaymentConditionType": "Netto",
  "PaymentConditionNumberOfDays": 8,
  "IsPerson": false
}

Response Information

Resource Description

201 (created) if the contact was successfully saved.

ContactCreatedResult
NameDescriptionType
ContactGuid

The guid of the contact

globally unique identifier
Sample:
{
  "ContactGuid": "31f4ee2e-ab77-47d0-89f0-9e3f0847e743"
}