POST v1/Customers

Add a new Customer.

Request Information

Requires Authorization!

URI Parameters

None.

Body Parameters

The Customer changes object

CustomerChanges
NameDescriptionTypeAdditional information
SyncShipToAddressOnSave

Gets or sets a value indicating whether the ship-to address is synchronized.

boolean

None.

SyncBillToAddressOnSave

Gets or sets a value indicating whether the bill-to address is synchronized.

boolean

None.

CustomerCode

Gets or sets the customer code.

string

Max length: 50

BillToAddress

Gets or sets the bill-to address.

ContactInfo

None.

ShipToAddress

Gets or sets the ship-to address.

ContactInfo

None.

ShopOwnerId

Gets or sets the shop owner identifier.

integer

Required

PersonTitle

Gets or sets the person title.

string

Max length: 50

FirstName

Gets or sets the first name.

string

Max length: 50

MiddleName

Gets or sets the middle name.

string

Max length: 50

LastNamePrefix

Gets or sets the last name prefix.

string

Max length: 50

LastName

Gets or sets the last name.

string

Max length: 50

CultureId

Gets or sets the culture identifier.

integer

None.

PersonalNumber

Gets or sets the personal number.

string

Max length: 20

ChangedTimestamp

Gets or sets the changed timestamp.

date

None.

Id

Gets or sets the identifier.

integer

Must be 0

FullName

Gets or sets the full name.

string

Max length: 100

CompanyName

Gets or sets the name of the company.

string

Max length: 100

EMail

Gets or sets the e mail.

string

None.

ContactReference

Gets or sets the contact reference.

string

None.

Request Formats

application/json, text/json

Sample:
{
  "SyncShipToAddressOnSave": true,
  "SyncBillToAddressOnSave": true,
  "CustomerCode": "sample string 3",
  "BillToAddress": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "FullName": "sample string 3",
    "Gender": "sample string 4",
    "PersonTitle": "sample string 5",
    "MiddleName": "sample string 6",
    "FirstName": "sample string 7",
    "LastName": "sample string 8",
    "LastNamePrefix": "sample string 9",
    "Address": "sample string 10",
    "Address2": "sample string 11",
    "StreetAddress": "sample string 12",
    "StreetAddressNumber": "sample string 13",
    "StreetAddressExtension": "sample string 14",
    "PostalCode": "sample string 15",
    "City": "sample string 16",
    "CountryId": 1,
    "CountryCode": "sample string 17",
    "EMail": "sample string 18",
    "Phone": "sample string 19",
    "Phone2": "sample string 20",
    "StateProvince": "sample string 21"
  },
  "ShipToAddress": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "FullName": "sample string 3",
    "Gender": "sample string 4",
    "PersonTitle": "sample string 5",
    "MiddleName": "sample string 6",
    "FirstName": "sample string 7",
    "LastName": "sample string 8",
    "LastNamePrefix": "sample string 9",
    "Address": "sample string 10",
    "Address2": "sample string 11",
    "StreetAddress": "sample string 12",
    "StreetAddressNumber": "sample string 13",
    "StreetAddressExtension": "sample string 14",
    "PostalCode": "sample string 15",
    "City": "sample string 16",
    "CountryId": 1,
    "CountryCode": "sample string 17",
    "EMail": "sample string 18",
    "Phone": "sample string 19",
    "Phone2": "sample string 20",
    "StateProvince": "sample string 21"
  },
  "ShopOwnerId": 1,
  "PersonTitle": "sample string 4",
  "FirstName": "sample string 5",
  "MiddleName": "sample string 6",
  "LastNamePrefix": "sample string 7",
  "LastName": "sample string 8",
  "CultureId": 1,
  "PersonalNumber": "sample string 9",
  "ChangedTimestamp": "2026-04-03T18:32:46.8529241+02:00",
  "Id": 10,
  "FullName": "sample string 11",
  "CompanyName": "sample string 12",
  "EMail": "sample string 13",
  "ContactReference": "sample string 14"
}

application/xml, text/xml

Sample:
<CustomerChanges xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Id>10</Id>
  <FullName>sample string 11</FullName>
  <CompanyName>sample string 12</CompanyName>
  <EMail>sample string 13</EMail>
  <ContactReference>sample string 14</ContactReference>
  <ShopOwnerId>1</ShopOwnerId>
  <PersonTitle>sample string 4</PersonTitle>
  <FirstName>sample string 5</FirstName>
  <MiddleName>sample string 6</MiddleName>
  <LastNamePrefix>sample string 7</LastNamePrefix>
  <LastName>sample string 8</LastName>
  <CultureId>1</CultureId>
  <PersonalNumber>sample string 9</PersonalNumber>
  <ChangedTimestamp>2026-04-03T18:32:46.8529241+02:00</ChangedTimestamp>
  <CustomerCode>sample string 3</CustomerCode>
  <BillToAddress>
    <Id>1</Id>
    <CompanyName>sample string 2</CompanyName>
    <FullName>sample string 3</FullName>
    <Gender>sample string 4</Gender>
    <PersonTitle>sample string 5</PersonTitle>
    <MiddleName>sample string 6</MiddleName>
    <FirstName>sample string 7</FirstName>
    <LastName>sample string 8</LastName>
    <LastNamePrefix>sample string 9</LastNamePrefix>
    <Address>sample string 10</Address>
    <Address2>sample string 11</Address2>
    <StreetAddress>sample string 12</StreetAddress>
    <StreetAddressNumber>sample string 13</StreetAddressNumber>
    <StreetAddressExtension>sample string 14</StreetAddressExtension>
    <PostalCode>sample string 15</PostalCode>
    <City>sample string 16</City>
    <CountryId>1</CountryId>
    <CountryCode>sample string 17</CountryCode>
    <EMail>sample string 18</EMail>
    <Phone>sample string 19</Phone>
    <Phone2>sample string 20</Phone2>
    <StateProvince>sample string 21</StateProvince>
  </BillToAddress>
  <ShipToAddress>
    <Id>1</Id>
    <CompanyName>sample string 2</CompanyName>
    <FullName>sample string 3</FullName>
    <Gender>sample string 4</Gender>
    <PersonTitle>sample string 5</PersonTitle>
    <MiddleName>sample string 6</MiddleName>
    <FirstName>sample string 7</FirstName>
    <LastName>sample string 8</LastName>
    <LastNamePrefix>sample string 9</LastNamePrefix>
    <Address>sample string 10</Address>
    <Address2>sample string 11</Address2>
    <StreetAddress>sample string 12</StreetAddress>
    <StreetAddressNumber>sample string 13</StreetAddressNumber>
    <StreetAddressExtension>sample string 14</StreetAddressExtension>
    <PostalCode>sample string 15</PostalCode>
    <City>sample string 16</City>
    <CountryId>1</CountryId>
    <CountryCode>sample string 17</CountryCode>
    <EMail>sample string 18</EMail>
    <Phone>sample string 19</Phone>
    <Phone2>sample string 20</Phone2>
    <StateProvince>sample string 21</StateProvince>
  </ShipToAddress>
  <SyncShipToAddressOnSave>true</SyncShipToAddressOnSave>
  <SyncBillToAddressOnSave>true</SyncBillToAddressOnSave>
</CustomerChanges>

Response Information

Resource Description

The Customer object.


Customer
NameDescriptionTypeAdditional information
CustomerCode

Gets or sets the customer code.

string

Max length: 50

BillToAddress

Gets or sets the bill-to address.

ContactInfo

None.

ShipToAddress

Gets or sets the ship-to address.

ContactInfo

None.

ShopOwnerId

Gets or sets the shop owner identifier.

integer

Required

PersonTitle

Gets or sets the person title.

string

Max length: 50

FirstName

Gets or sets the first name.

string

Max length: 50

MiddleName

Gets or sets the middle name.

string

Max length: 50

LastNamePrefix

Gets or sets the last name prefix.

string

Max length: 50

LastName

Gets or sets the last name.

string

Max length: 50

CultureId

Gets or sets the culture identifier.

integer

None.

PersonalNumber

Gets or sets the personal number.

string

Max length: 20

ChangedTimestamp

Gets or sets the changed timestamp.

date

None.

Id

Gets or sets the identifier.

integer

Must be 0

FullName

Gets or sets the full name.

string

Max length: 100

CompanyName

Gets or sets the name of the company.

string

Max length: 100

EMail

Gets or sets the e mail.

string

None.

ContactReference

Gets or sets the contact reference.

string

None.

Response Formats

application/json, text/json

Sample:
{
  "CustomerCode": "sample string 1",
  "BillToAddress": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "FullName": "sample string 3",
    "Gender": "sample string 4",
    "PersonTitle": "sample string 5",
    "MiddleName": "sample string 6",
    "FirstName": "sample string 7",
    "LastName": "sample string 8",
    "LastNamePrefix": "sample string 9",
    "Address": "sample string 10",
    "Address2": "sample string 11",
    "StreetAddress": "sample string 12",
    "StreetAddressNumber": "sample string 13",
    "StreetAddressExtension": "sample string 14",
    "PostalCode": "sample string 15",
    "City": "sample string 16",
    "CountryId": 1,
    "CountryCode": "sample string 17",
    "EMail": "sample string 18",
    "Phone": "sample string 19",
    "Phone2": "sample string 20",
    "StateProvince": "sample string 21"
  },
  "ShipToAddress": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "FullName": "sample string 3",
    "Gender": "sample string 4",
    "PersonTitle": "sample string 5",
    "MiddleName": "sample string 6",
    "FirstName": "sample string 7",
    "LastName": "sample string 8",
    "LastNamePrefix": "sample string 9",
    "Address": "sample string 10",
    "Address2": "sample string 11",
    "StreetAddress": "sample string 12",
    "StreetAddressNumber": "sample string 13",
    "StreetAddressExtension": "sample string 14",
    "PostalCode": "sample string 15",
    "City": "sample string 16",
    "CountryId": 1,
    "CountryCode": "sample string 17",
    "EMail": "sample string 18",
    "Phone": "sample string 19",
    "Phone2": "sample string 20",
    "StateProvince": "sample string 21"
  },
  "ShopOwnerId": 1,
  "PersonTitle": "sample string 2",
  "FirstName": "sample string 3",
  "MiddleName": "sample string 4",
  "LastNamePrefix": "sample string 5",
  "LastName": "sample string 6",
  "CultureId": 1,
  "PersonalNumber": "sample string 7",
  "ChangedTimestamp": "2026-04-03T18:32:46.8529241+02:00",
  "Id": 8,
  "FullName": "sample string 9",
  "CompanyName": "sample string 10",
  "EMail": "sample string 11",
  "ContactReference": "sample string 12"
}

application/xml, text/xml

Sample:
<Customer xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Id>8</Id>
  <FullName>sample string 9</FullName>
  <CompanyName>sample string 10</CompanyName>
  <EMail>sample string 11</EMail>
  <ContactReference>sample string 12</ContactReference>
  <ShopOwnerId>1</ShopOwnerId>
  <PersonTitle>sample string 2</PersonTitle>
  <FirstName>sample string 3</FirstName>
  <MiddleName>sample string 4</MiddleName>
  <LastNamePrefix>sample string 5</LastNamePrefix>
  <LastName>sample string 6</LastName>
  <CultureId>1</CultureId>
  <PersonalNumber>sample string 7</PersonalNumber>
  <ChangedTimestamp>2026-04-03T18:32:46.8529241+02:00</ChangedTimestamp>
  <CustomerCode>sample string 1</CustomerCode>
  <BillToAddress>
    <Id>1</Id>
    <CompanyName>sample string 2</CompanyName>
    <FullName>sample string 3</FullName>
    <Gender>sample string 4</Gender>
    <PersonTitle>sample string 5</PersonTitle>
    <MiddleName>sample string 6</MiddleName>
    <FirstName>sample string 7</FirstName>
    <LastName>sample string 8</LastName>
    <LastNamePrefix>sample string 9</LastNamePrefix>
    <Address>sample string 10</Address>
    <Address2>sample string 11</Address2>
    <StreetAddress>sample string 12</StreetAddress>
    <StreetAddressNumber>sample string 13</StreetAddressNumber>
    <StreetAddressExtension>sample string 14</StreetAddressExtension>
    <PostalCode>sample string 15</PostalCode>
    <City>sample string 16</City>
    <CountryId>1</CountryId>
    <CountryCode>sample string 17</CountryCode>
    <EMail>sample string 18</EMail>
    <Phone>sample string 19</Phone>
    <Phone2>sample string 20</Phone2>
    <StateProvince>sample string 21</StateProvince>
  </BillToAddress>
  <ShipToAddress>
    <Id>1</Id>
    <CompanyName>sample string 2</CompanyName>
    <FullName>sample string 3</FullName>
    <Gender>sample string 4</Gender>
    <PersonTitle>sample string 5</PersonTitle>
    <MiddleName>sample string 6</MiddleName>
    <FirstName>sample string 7</FirstName>
    <LastName>sample string 8</LastName>
    <LastNamePrefix>sample string 9</LastNamePrefix>
    <Address>sample string 10</Address>
    <Address2>sample string 11</Address2>
    <StreetAddress>sample string 12</StreetAddress>
    <StreetAddressNumber>sample string 13</StreetAddressNumber>
    <StreetAddressExtension>sample string 14</StreetAddressExtension>
    <PostalCode>sample string 15</PostalCode>
    <City>sample string 16</City>
    <CountryId>1</CountryId>
    <CountryCode>sample string 17</CountryCode>
    <EMail>sample string 18</EMail>
    <Phone>sample string 19</Phone>
    <Phone2>sample string 20</Phone2>
    <StateProvince>sample string 21</StateProvince>
  </ShipToAddress>
</Customer>