Create Customer

Create Customer

curl --request POST \
  --url https://api.jtl-cloud.com/erp/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "CustomerGroupId": 123,
  "BillingAddress": {
    "City": "<string>",
    "CountryIso": "<string>",
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "State": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "LanguageIso": "<string>",
  "InternalCompanyId": 123,
  "Number": "<string>",
  "OtherAddresses": {
    "OtherBillingAddresses": [
      {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherShippingAddresses": [
      {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherCustomerAddresses": [
      {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ]
  },
  "PaymentSettings": {
    "PaymentMethodId": 123,
    "Discount": 123,
    "PaymentTarget": 123,
    "CreditLimit": 123,
    "StopPaymentRequest": true
  },
  "CustomerSince": "2023-11-07T05:31:56Z",
  "LastChange": "2023-11-07T05:31:56Z",
  "CustomerCategoryId": 123,
  "TaxIdentificationNumber": "<string>",
  "AccountsReceivableNumber": 123,
  "CommercialRegisterNumber": "<string>",
  "Website": "<string>",
  "InitialContact": "<string>",
  "EbayUsername": "<string>",
  "Birthday": "2023-11-07T05:31:56Z",
  "IsLocked": true,
  "IsCashRegisterBased": true
}
'

import requests

url = "https://api.jtl-cloud.com/erp/v1/customers"

payload = {
    "CustomerGroupId": 123,
    "BillingAddress": {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
    },
    "LanguageIso": "<string>",
    "InternalCompanyId": 123,
    "Number": "<string>",
    "OtherAddresses": {
        "OtherBillingAddresses": [
            {
                "City": "<string>",
                "CountryIso": "<string>",
                "Company": "<string>",
                "Company2": "<string>",
                "FormOfAddress": "<string>",
                "Title": "<string>",
                "FirstName": "<string>",
                "LastName": "<string>",
                "Street": "<string>",
                "Address2": "<string>",
                "PostalCode": "<string>",
                "State": "<string>",
                "VatID": "<string>",
                "PhoneNumber": "<string>",
                "MobilePhoneNumber": "<string>",
                "EmailAddress": "<string>",
                "Fax": "<string>"
            }
        ],
        "OtherShippingAddresses": [
            {
                "City": "<string>",
                "CountryIso": "<string>",
                "Company": "<string>",
                "Company2": "<string>",
                "FormOfAddress": "<string>",
                "Title": "<string>",
                "FirstName": "<string>",
                "LastName": "<string>",
                "Street": "<string>",
                "Address2": "<string>",
                "PostalCode": "<string>",
                "State": "<string>",
                "VatID": "<string>",
                "PhoneNumber": "<string>",
                "MobilePhoneNumber": "<string>",
                "EmailAddress": "<string>",
                "Fax": "<string>"
            }
        ],
        "OtherCustomerAddresses": [
            {
                "City": "<string>",
                "CountryIso": "<string>",
                "Company": "<string>",
                "Company2": "<string>",
                "FormOfAddress": "<string>",
                "Title": "<string>",
                "FirstName": "<string>",
                "LastName": "<string>",
                "Street": "<string>",
                "Address2": "<string>",
                "PostalCode": "<string>",
                "State": "<string>",
                "VatID": "<string>",
                "PhoneNumber": "<string>",
                "MobilePhoneNumber": "<string>",
                "EmailAddress": "<string>",
                "Fax": "<string>"
            }
        ]
    },
    "PaymentSettings": {
        "PaymentMethodId": 123,
        "Discount": 123,
        "PaymentTarget": 123,
        "CreditLimit": 123,
        "StopPaymentRequest": True
    },
    "CustomerSince": "2023-11-07T05:31:56Z",
    "LastChange": "2023-11-07T05:31:56Z",
    "CustomerCategoryId": 123,
    "TaxIdentificationNumber": "<string>",
    "AccountsReceivableNumber": 123,
    "CommercialRegisterNumber": "<string>",
    "Website": "<string>",
    "InitialContact": "<string>",
    "EbayUsername": "<string>",
    "Birthday": "2023-11-07T05:31:56Z",
    "IsLocked": True,
    "IsCashRegisterBased": True
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    CustomerGroupId: 123,
    BillingAddress: {
      City: '<string>',
      CountryIso: '<string>',
      Company: '<string>',
      Company2: '<string>',
      FormOfAddress: '<string>',
      Title: '<string>',
      FirstName: '<string>',
      LastName: '<string>',
      Street: '<string>',
      Address2: '<string>',
      PostalCode: '<string>',
      State: '<string>',
      VatID: '<string>',
      PhoneNumber: '<string>',
      MobilePhoneNumber: '<string>',
      EmailAddress: '<string>',
      Fax: '<string>'
    },
    LanguageIso: '<string>',
    InternalCompanyId: 123,
    Number: '<string>',
    OtherAddresses: {
      OtherBillingAddresses: [
        {
          City: '<string>',
          CountryIso: '<string>',
          Company: '<string>',
          Company2: '<string>',
          FormOfAddress: '<string>',
          Title: '<string>',
          FirstName: '<string>',
          LastName: '<string>',
          Street: '<string>',
          Address2: '<string>',
          PostalCode: '<string>',
          State: '<string>',
          VatID: '<string>',
          PhoneNumber: '<string>',
          MobilePhoneNumber: '<string>',
          EmailAddress: '<string>',
          Fax: '<string>'
        }
      ],
      OtherShippingAddresses: [
        {
          City: '<string>',
          CountryIso: '<string>',
          Company: '<string>',
          Company2: '<string>',
          FormOfAddress: '<string>',
          Title: '<string>',
          FirstName: '<string>',
          LastName: '<string>',
          Street: '<string>',
          Address2: '<string>',
          PostalCode: '<string>',
          State: '<string>',
          VatID: '<string>',
          PhoneNumber: '<string>',
          MobilePhoneNumber: '<string>',
          EmailAddress: '<string>',
          Fax: '<string>'
        }
      ],
      OtherCustomerAddresses: [
        {
          City: '<string>',
          CountryIso: '<string>',
          Company: '<string>',
          Company2: '<string>',
          FormOfAddress: '<string>',
          Title: '<string>',
          FirstName: '<string>',
          LastName: '<string>',
          Street: '<string>',
          Address2: '<string>',
          PostalCode: '<string>',
          State: '<string>',
          VatID: '<string>',
          PhoneNumber: '<string>',
          MobilePhoneNumber: '<string>',
          EmailAddress: '<string>',
          Fax: '<string>'
        }
      ]
    },
    PaymentSettings: {
      PaymentMethodId: 123,
      Discount: 123,
      PaymentTarget: 123,
      CreditLimit: 123,
      StopPaymentRequest: true
    },
    CustomerSince: '2023-11-07T05:31:56Z',
    LastChange: '2023-11-07T05:31:56Z',
    CustomerCategoryId: 123,
    TaxIdentificationNumber: '<string>',
    AccountsReceivableNumber: 123,
    CommercialRegisterNumber: '<string>',
    Website: '<string>',
    InitialContact: '<string>',
    EbayUsername: '<string>',
    Birthday: '2023-11-07T05:31:56Z',
    IsLocked: true,
    IsCashRegisterBased: true
  })
};

fetch('https://api.jtl-cloud.com/erp/v1/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jtl-cloud.com/erp/v1/customers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'CustomerGroupId' => 123,
    'BillingAddress' => [
        'City' => '<string>',
        'CountryIso' => '<string>',
        'Company' => '<string>',
        'Company2' => '<string>',
        'FormOfAddress' => '<string>',
        'Title' => '<string>',
        'FirstName' => '<string>',
        'LastName' => '<string>',
        'Street' => '<string>',
        'Address2' => '<string>',
        'PostalCode' => '<string>',
        'State' => '<string>',
        'VatID' => '<string>',
        'PhoneNumber' => '<string>',
        'MobilePhoneNumber' => '<string>',
        'EmailAddress' => '<string>',
        'Fax' => '<string>'
    ],
    'LanguageIso' => '<string>',
    'InternalCompanyId' => 123,
    'Number' => '<string>',
    'OtherAddresses' => [
        'OtherBillingAddresses' => [
                [
                                'City' => '<string>',
                                'CountryIso' => '<string>',
                                'Company' => '<string>',
                                'Company2' => '<string>',
                                'FormOfAddress' => '<string>',
                                'Title' => '<string>',
                                'FirstName' => '<string>',
                                'LastName' => '<string>',
                                'Street' => '<string>',
                                'Address2' => '<string>',
                                'PostalCode' => '<string>',
                                'State' => '<string>',
                                'VatID' => '<string>',
                                'PhoneNumber' => '<string>',
                                'MobilePhoneNumber' => '<string>',
                                'EmailAddress' => '<string>',
                                'Fax' => '<string>'
                ]
        ],
        'OtherShippingAddresses' => [
                [
                                'City' => '<string>',
                                'CountryIso' => '<string>',
                                'Company' => '<string>',
                                'Company2' => '<string>',
                                'FormOfAddress' => '<string>',
                                'Title' => '<string>',
                                'FirstName' => '<string>',
                                'LastName' => '<string>',
                                'Street' => '<string>',
                                'Address2' => '<string>',
                                'PostalCode' => '<string>',
                                'State' => '<string>',
                                'VatID' => '<string>',
                                'PhoneNumber' => '<string>',
                                'MobilePhoneNumber' => '<string>',
                                'EmailAddress' => '<string>',
                                'Fax' => '<string>'
                ]
        ],
        'OtherCustomerAddresses' => [
                [
                                'City' => '<string>',
                                'CountryIso' => '<string>',
                                'Company' => '<string>',
                                'Company2' => '<string>',
                                'FormOfAddress' => '<string>',
                                'Title' => '<string>',
                                'FirstName' => '<string>',
                                'LastName' => '<string>',
                                'Street' => '<string>',
                                'Address2' => '<string>',
                                'PostalCode' => '<string>',
                                'State' => '<string>',
                                'VatID' => '<string>',
                                'PhoneNumber' => '<string>',
                                'MobilePhoneNumber' => '<string>',
                                'EmailAddress' => '<string>',
                                'Fax' => '<string>'
                ]
        ]
    ],
    'PaymentSettings' => [
        'PaymentMethodId' => 123,
        'Discount' => 123,
        'PaymentTarget' => 123,
        'CreditLimit' => 123,
        'StopPaymentRequest' => true
    ],
    'CustomerSince' => '2023-11-07T05:31:56Z',
    'LastChange' => '2023-11-07T05:31:56Z',
    'CustomerCategoryId' => 123,
    'TaxIdentificationNumber' => '<string>',
    'AccountsReceivableNumber' => 123,
    'CommercialRegisterNumber' => '<string>',
    'Website' => '<string>',
    'InitialContact' => '<string>',
    'EbayUsername' => '<string>',
    'Birthday' => '2023-11-07T05:31:56Z',
    'IsLocked' => true,
    'IsCashRegisterBased' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/v1/customers"

	payload := strings.NewReader("{\n  \"CustomerGroupId\": 123,\n  \"BillingAddress\": {\n    \"City\": \"<string>\",\n    \"CountryIso\": \"<string>\",\n    \"Company\": \"<string>\",\n    \"Company2\": \"<string>\",\n    \"FormOfAddress\": \"<string>\",\n    \"Title\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"Street\": \"<string>\",\n    \"Address2\": \"<string>\",\n    \"PostalCode\": \"<string>\",\n    \"State\": \"<string>\",\n    \"VatID\": \"<string>\",\n    \"PhoneNumber\": \"<string>\",\n    \"MobilePhoneNumber\": \"<string>\",\n    \"EmailAddress\": \"<string>\",\n    \"Fax\": \"<string>\"\n  },\n  \"LanguageIso\": \"<string>\",\n  \"InternalCompanyId\": 123,\n  \"Number\": \"<string>\",\n  \"OtherAddresses\": {\n    \"OtherBillingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherShippingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherCustomerAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ]\n  },\n  \"PaymentSettings\": {\n    \"PaymentMethodId\": 123,\n    \"Discount\": 123,\n    \"PaymentTarget\": 123,\n    \"CreditLimit\": 123,\n    \"StopPaymentRequest\": true\n  },\n  \"CustomerSince\": \"2023-11-07T05:31:56Z\",\n  \"LastChange\": \"2023-11-07T05:31:56Z\",\n  \"CustomerCategoryId\": 123,\n  \"TaxIdentificationNumber\": \"<string>\",\n  \"AccountsReceivableNumber\": 123,\n  \"CommercialRegisterNumber\": \"<string>\",\n  \"Website\": \"<string>\",\n  \"InitialContact\": \"<string>\",\n  \"EbayUsername\": \"<string>\",\n  \"Birthday\": \"2023-11-07T05:31:56Z\",\n  \"IsLocked\": true,\n  \"IsCashRegisterBased\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.jtl-cloud.com/erp/v1/customers")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"CustomerGroupId\": 123,\n  \"BillingAddress\": {\n    \"City\": \"<string>\",\n    \"CountryIso\": \"<string>\",\n    \"Company\": \"<string>\",\n    \"Company2\": \"<string>\",\n    \"FormOfAddress\": \"<string>\",\n    \"Title\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"Street\": \"<string>\",\n    \"Address2\": \"<string>\",\n    \"PostalCode\": \"<string>\",\n    \"State\": \"<string>\",\n    \"VatID\": \"<string>\",\n    \"PhoneNumber\": \"<string>\",\n    \"MobilePhoneNumber\": \"<string>\",\n    \"EmailAddress\": \"<string>\",\n    \"Fax\": \"<string>\"\n  },\n  \"LanguageIso\": \"<string>\",\n  \"InternalCompanyId\": 123,\n  \"Number\": \"<string>\",\n  \"OtherAddresses\": {\n    \"OtherBillingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherShippingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherCustomerAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ]\n  },\n  \"PaymentSettings\": {\n    \"PaymentMethodId\": 123,\n    \"Discount\": 123,\n    \"PaymentTarget\": 123,\n    \"CreditLimit\": 123,\n    \"StopPaymentRequest\": true\n  },\n  \"CustomerSince\": \"2023-11-07T05:31:56Z\",\n  \"LastChange\": \"2023-11-07T05:31:56Z\",\n  \"CustomerCategoryId\": 123,\n  \"TaxIdentificationNumber\": \"<string>\",\n  \"AccountsReceivableNumber\": 123,\n  \"CommercialRegisterNumber\": \"<string>\",\n  \"Website\": \"<string>\",\n  \"InitialContact\": \"<string>\",\n  \"EbayUsername\": \"<string>\",\n  \"Birthday\": \"2023-11-07T05:31:56Z\",\n  \"IsLocked\": true,\n  \"IsCashRegisterBased\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/v1/customers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"CustomerGroupId\": 123,\n  \"BillingAddress\": {\n    \"City\": \"<string>\",\n    \"CountryIso\": \"<string>\",\n    \"Company\": \"<string>\",\n    \"Company2\": \"<string>\",\n    \"FormOfAddress\": \"<string>\",\n    \"Title\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"Street\": \"<string>\",\n    \"Address2\": \"<string>\",\n    \"PostalCode\": \"<string>\",\n    \"State\": \"<string>\",\n    \"VatID\": \"<string>\",\n    \"PhoneNumber\": \"<string>\",\n    \"MobilePhoneNumber\": \"<string>\",\n    \"EmailAddress\": \"<string>\",\n    \"Fax\": \"<string>\"\n  },\n  \"LanguageIso\": \"<string>\",\n  \"InternalCompanyId\": 123,\n  \"Number\": \"<string>\",\n  \"OtherAddresses\": {\n    \"OtherBillingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherShippingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherCustomerAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ]\n  },\n  \"PaymentSettings\": {\n    \"PaymentMethodId\": 123,\n    \"Discount\": 123,\n    \"PaymentTarget\": 123,\n    \"CreditLimit\": 123,\n    \"StopPaymentRequest\": true\n  },\n  \"CustomerSince\": \"2023-11-07T05:31:56Z\",\n  \"LastChange\": \"2023-11-07T05:31:56Z\",\n  \"CustomerCategoryId\": 123,\n  \"TaxIdentificationNumber\": \"<string>\",\n  \"AccountsReceivableNumber\": 123,\n  \"CommercialRegisterNumber\": \"<string>\",\n  \"Website\": \"<string>\",\n  \"InitialContact\": \"<string>\",\n  \"EbayUsername\": \"<string>\",\n  \"Birthday\": \"2023-11-07T05:31:56Z\",\n  \"IsLocked\": true,\n  \"IsCashRegisterBased\": true\n}"

response = http.request(request)
puts response.read_body

{
  "Id": 123,
  "Number": "<string>",
  "CustomerGroupId": 123,
  "BillingAddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "Shipmentaddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "CustomAddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "OtherAddresses": {
    "OtherBillingAddresses": [
      {
        "Id": 123,
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "City": "<string>",
        "State": "<string>",
        "CountryIso": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherShippingAddresses": [
      {
        "Id": 123,
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "City": "<string>",
        "State": "<string>",
        "CountryIso": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherCustomerAddresses": [
      {
        "Id": 123,
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "City": "<string>",
        "State": "<string>",
        "CountryIso": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ]
  },
  "PaymentSettings": {
    "PaymentMethodId": 123,
    "Discount": 123,
    "PaymentTarget": 123,
    "CreditLimit": 123,
    "StopPaymentRequest": true
  },
  "CustomerSince": "2023-11-07T05:31:56Z",
  "LastChange": "2023-11-07T05:31:56Z",
  "LanguageIso": "<string>",
  "InternalCompanyId": 123,
  "CustomerCategoryId": 123,
  "TaxIdentificationNumber": "<string>",
  "AccountsReceivableNumber": 123,
  "CommercialRegisterNumber": "<string>",
  "Website": "<string>",
  "InitialContact": "<string>",
  "EbayUsername": "<string>",
  "Birthday": "2023-11-07T05:31:56Z",
  "IsLocked": true,
  "IsCashRegisterBased": true
}

{
  "ErrorCode": "<string>",
  "ValidationErrors": {},
  "Errors": {},
  "ErrorMessage": "<string>",
  "Stacktrace": "<string>"
}

POST

customers

Create Customer

curl --request POST \
  --url https://api.jtl-cloud.com/erp/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "CustomerGroupId": 123,
  "BillingAddress": {
    "City": "<string>",
    "CountryIso": "<string>",
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "State": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "LanguageIso": "<string>",
  "InternalCompanyId": 123,
  "Number": "<string>",
  "OtherAddresses": {
    "OtherBillingAddresses": [
      {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherShippingAddresses": [
      {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherCustomerAddresses": [
      {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ]
  },
  "PaymentSettings": {
    "PaymentMethodId": 123,
    "Discount": 123,
    "PaymentTarget": 123,
    "CreditLimit": 123,
    "StopPaymentRequest": true
  },
  "CustomerSince": "2023-11-07T05:31:56Z",
  "LastChange": "2023-11-07T05:31:56Z",
  "CustomerCategoryId": 123,
  "TaxIdentificationNumber": "<string>",
  "AccountsReceivableNumber": 123,
  "CommercialRegisterNumber": "<string>",
  "Website": "<string>",
  "InitialContact": "<string>",
  "EbayUsername": "<string>",
  "Birthday": "2023-11-07T05:31:56Z",
  "IsLocked": true,
  "IsCashRegisterBased": true
}
'

import requests

url = "https://api.jtl-cloud.com/erp/v1/customers"

payload = {
    "CustomerGroupId": 123,
    "BillingAddress": {
        "City": "<string>",
        "CountryIso": "<string>",
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "State": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
    },
    "LanguageIso": "<string>",
    "InternalCompanyId": 123,
    "Number": "<string>",
    "OtherAddresses": {
        "OtherBillingAddresses": [
            {
                "City": "<string>",
                "CountryIso": "<string>",
                "Company": "<string>",
                "Company2": "<string>",
                "FormOfAddress": "<string>",
                "Title": "<string>",
                "FirstName": "<string>",
                "LastName": "<string>",
                "Street": "<string>",
                "Address2": "<string>",
                "PostalCode": "<string>",
                "State": "<string>",
                "VatID": "<string>",
                "PhoneNumber": "<string>",
                "MobilePhoneNumber": "<string>",
                "EmailAddress": "<string>",
                "Fax": "<string>"
            }
        ],
        "OtherShippingAddresses": [
            {
                "City": "<string>",
                "CountryIso": "<string>",
                "Company": "<string>",
                "Company2": "<string>",
                "FormOfAddress": "<string>",
                "Title": "<string>",
                "FirstName": "<string>",
                "LastName": "<string>",
                "Street": "<string>",
                "Address2": "<string>",
                "PostalCode": "<string>",
                "State": "<string>",
                "VatID": "<string>",
                "PhoneNumber": "<string>",
                "MobilePhoneNumber": "<string>",
                "EmailAddress": "<string>",
                "Fax": "<string>"
            }
        ],
        "OtherCustomerAddresses": [
            {
                "City": "<string>",
                "CountryIso": "<string>",
                "Company": "<string>",
                "Company2": "<string>",
                "FormOfAddress": "<string>",
                "Title": "<string>",
                "FirstName": "<string>",
                "LastName": "<string>",
                "Street": "<string>",
                "Address2": "<string>",
                "PostalCode": "<string>",
                "State": "<string>",
                "VatID": "<string>",
                "PhoneNumber": "<string>",
                "MobilePhoneNumber": "<string>",
                "EmailAddress": "<string>",
                "Fax": "<string>"
            }
        ]
    },
    "PaymentSettings": {
        "PaymentMethodId": 123,
        "Discount": 123,
        "PaymentTarget": 123,
        "CreditLimit": 123,
        "StopPaymentRequest": True
    },
    "CustomerSince": "2023-11-07T05:31:56Z",
    "LastChange": "2023-11-07T05:31:56Z",
    "CustomerCategoryId": 123,
    "TaxIdentificationNumber": "<string>",
    "AccountsReceivableNumber": 123,
    "CommercialRegisterNumber": "<string>",
    "Website": "<string>",
    "InitialContact": "<string>",
    "EbayUsername": "<string>",
    "Birthday": "2023-11-07T05:31:56Z",
    "IsLocked": True,
    "IsCashRegisterBased": True
}
headers = {
    "x-tenant-id": "<x-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-tenant-id': '<x-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    CustomerGroupId: 123,
    BillingAddress: {
      City: '<string>',
      CountryIso: '<string>',
      Company: '<string>',
      Company2: '<string>',
      FormOfAddress: '<string>',
      Title: '<string>',
      FirstName: '<string>',
      LastName: '<string>',
      Street: '<string>',
      Address2: '<string>',
      PostalCode: '<string>',
      State: '<string>',
      VatID: '<string>',
      PhoneNumber: '<string>',
      MobilePhoneNumber: '<string>',
      EmailAddress: '<string>',
      Fax: '<string>'
    },
    LanguageIso: '<string>',
    InternalCompanyId: 123,
    Number: '<string>',
    OtherAddresses: {
      OtherBillingAddresses: [
        {
          City: '<string>',
          CountryIso: '<string>',
          Company: '<string>',
          Company2: '<string>',
          FormOfAddress: '<string>',
          Title: '<string>',
          FirstName: '<string>',
          LastName: '<string>',
          Street: '<string>',
          Address2: '<string>',
          PostalCode: '<string>',
          State: '<string>',
          VatID: '<string>',
          PhoneNumber: '<string>',
          MobilePhoneNumber: '<string>',
          EmailAddress: '<string>',
          Fax: '<string>'
        }
      ],
      OtherShippingAddresses: [
        {
          City: '<string>',
          CountryIso: '<string>',
          Company: '<string>',
          Company2: '<string>',
          FormOfAddress: '<string>',
          Title: '<string>',
          FirstName: '<string>',
          LastName: '<string>',
          Street: '<string>',
          Address2: '<string>',
          PostalCode: '<string>',
          State: '<string>',
          VatID: '<string>',
          PhoneNumber: '<string>',
          MobilePhoneNumber: '<string>',
          EmailAddress: '<string>',
          Fax: '<string>'
        }
      ],
      OtherCustomerAddresses: [
        {
          City: '<string>',
          CountryIso: '<string>',
          Company: '<string>',
          Company2: '<string>',
          FormOfAddress: '<string>',
          Title: '<string>',
          FirstName: '<string>',
          LastName: '<string>',
          Street: '<string>',
          Address2: '<string>',
          PostalCode: '<string>',
          State: '<string>',
          VatID: '<string>',
          PhoneNumber: '<string>',
          MobilePhoneNumber: '<string>',
          EmailAddress: '<string>',
          Fax: '<string>'
        }
      ]
    },
    PaymentSettings: {
      PaymentMethodId: 123,
      Discount: 123,
      PaymentTarget: 123,
      CreditLimit: 123,
      StopPaymentRequest: true
    },
    CustomerSince: '2023-11-07T05:31:56Z',
    LastChange: '2023-11-07T05:31:56Z',
    CustomerCategoryId: 123,
    TaxIdentificationNumber: '<string>',
    AccountsReceivableNumber: 123,
    CommercialRegisterNumber: '<string>',
    Website: '<string>',
    InitialContact: '<string>',
    EbayUsername: '<string>',
    Birthday: '2023-11-07T05:31:56Z',
    IsLocked: true,
    IsCashRegisterBased: true
  })
};

fetch('https://api.jtl-cloud.com/erp/v1/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jtl-cloud.com/erp/v1/customers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'CustomerGroupId' => 123,
    'BillingAddress' => [
        'City' => '<string>',
        'CountryIso' => '<string>',
        'Company' => '<string>',
        'Company2' => '<string>',
        'FormOfAddress' => '<string>',
        'Title' => '<string>',
        'FirstName' => '<string>',
        'LastName' => '<string>',
        'Street' => '<string>',
        'Address2' => '<string>',
        'PostalCode' => '<string>',
        'State' => '<string>',
        'VatID' => '<string>',
        'PhoneNumber' => '<string>',
        'MobilePhoneNumber' => '<string>',
        'EmailAddress' => '<string>',
        'Fax' => '<string>'
    ],
    'LanguageIso' => '<string>',
    'InternalCompanyId' => 123,
    'Number' => '<string>',
    'OtherAddresses' => [
        'OtherBillingAddresses' => [
                [
                                'City' => '<string>',
                                'CountryIso' => '<string>',
                                'Company' => '<string>',
                                'Company2' => '<string>',
                                'FormOfAddress' => '<string>',
                                'Title' => '<string>',
                                'FirstName' => '<string>',
                                'LastName' => '<string>',
                                'Street' => '<string>',
                                'Address2' => '<string>',
                                'PostalCode' => '<string>',
                                'State' => '<string>',
                                'VatID' => '<string>',
                                'PhoneNumber' => '<string>',
                                'MobilePhoneNumber' => '<string>',
                                'EmailAddress' => '<string>',
                                'Fax' => '<string>'
                ]
        ],
        'OtherShippingAddresses' => [
                [
                                'City' => '<string>',
                                'CountryIso' => '<string>',
                                'Company' => '<string>',
                                'Company2' => '<string>',
                                'FormOfAddress' => '<string>',
                                'Title' => '<string>',
                                'FirstName' => '<string>',
                                'LastName' => '<string>',
                                'Street' => '<string>',
                                'Address2' => '<string>',
                                'PostalCode' => '<string>',
                                'State' => '<string>',
                                'VatID' => '<string>',
                                'PhoneNumber' => '<string>',
                                'MobilePhoneNumber' => '<string>',
                                'EmailAddress' => '<string>',
                                'Fax' => '<string>'
                ]
        ],
        'OtherCustomerAddresses' => [
                [
                                'City' => '<string>',
                                'CountryIso' => '<string>',
                                'Company' => '<string>',
                                'Company2' => '<string>',
                                'FormOfAddress' => '<string>',
                                'Title' => '<string>',
                                'FirstName' => '<string>',
                                'LastName' => '<string>',
                                'Street' => '<string>',
                                'Address2' => '<string>',
                                'PostalCode' => '<string>',
                                'State' => '<string>',
                                'VatID' => '<string>',
                                'PhoneNumber' => '<string>',
                                'MobilePhoneNumber' => '<string>',
                                'EmailAddress' => '<string>',
                                'Fax' => '<string>'
                ]
        ]
    ],
    'PaymentSettings' => [
        'PaymentMethodId' => 123,
        'Discount' => 123,
        'PaymentTarget' => 123,
        'CreditLimit' => 123,
        'StopPaymentRequest' => true
    ],
    'CustomerSince' => '2023-11-07T05:31:56Z',
    'LastChange' => '2023-11-07T05:31:56Z',
    'CustomerCategoryId' => 123,
    'TaxIdentificationNumber' => '<string>',
    'AccountsReceivableNumber' => 123,
    'CommercialRegisterNumber' => '<string>',
    'Website' => '<string>',
    'InitialContact' => '<string>',
    'EbayUsername' => '<string>',
    'Birthday' => '2023-11-07T05:31:56Z',
    'IsLocked' => true,
    'IsCashRegisterBased' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-tenant-id: <x-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jtl-cloud.com/erp/v1/customers"

	payload := strings.NewReader("{\n  \"CustomerGroupId\": 123,\n  \"BillingAddress\": {\n    \"City\": \"<string>\",\n    \"CountryIso\": \"<string>\",\n    \"Company\": \"<string>\",\n    \"Company2\": \"<string>\",\n    \"FormOfAddress\": \"<string>\",\n    \"Title\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"Street\": \"<string>\",\n    \"Address2\": \"<string>\",\n    \"PostalCode\": \"<string>\",\n    \"State\": \"<string>\",\n    \"VatID\": \"<string>\",\n    \"PhoneNumber\": \"<string>\",\n    \"MobilePhoneNumber\": \"<string>\",\n    \"EmailAddress\": \"<string>\",\n    \"Fax\": \"<string>\"\n  },\n  \"LanguageIso\": \"<string>\",\n  \"InternalCompanyId\": 123,\n  \"Number\": \"<string>\",\n  \"OtherAddresses\": {\n    \"OtherBillingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherShippingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherCustomerAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ]\n  },\n  \"PaymentSettings\": {\n    \"PaymentMethodId\": 123,\n    \"Discount\": 123,\n    \"PaymentTarget\": 123,\n    \"CreditLimit\": 123,\n    \"StopPaymentRequest\": true\n  },\n  \"CustomerSince\": \"2023-11-07T05:31:56Z\",\n  \"LastChange\": \"2023-11-07T05:31:56Z\",\n  \"CustomerCategoryId\": 123,\n  \"TaxIdentificationNumber\": \"<string>\",\n  \"AccountsReceivableNumber\": 123,\n  \"CommercialRegisterNumber\": \"<string>\",\n  \"Website\": \"<string>\",\n  \"InitialContact\": \"<string>\",\n  \"EbayUsername\": \"<string>\",\n  \"Birthday\": \"2023-11-07T05:31:56Z\",\n  \"IsLocked\": true,\n  \"IsCashRegisterBased\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-tenant-id", "<x-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.jtl-cloud.com/erp/v1/customers")
  .header("x-tenant-id", "<x-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"CustomerGroupId\": 123,\n  \"BillingAddress\": {\n    \"City\": \"<string>\",\n    \"CountryIso\": \"<string>\",\n    \"Company\": \"<string>\",\n    \"Company2\": \"<string>\",\n    \"FormOfAddress\": \"<string>\",\n    \"Title\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"Street\": \"<string>\",\n    \"Address2\": \"<string>\",\n    \"PostalCode\": \"<string>\",\n    \"State\": \"<string>\",\n    \"VatID\": \"<string>\",\n    \"PhoneNumber\": \"<string>\",\n    \"MobilePhoneNumber\": \"<string>\",\n    \"EmailAddress\": \"<string>\",\n    \"Fax\": \"<string>\"\n  },\n  \"LanguageIso\": \"<string>\",\n  \"InternalCompanyId\": 123,\n  \"Number\": \"<string>\",\n  \"OtherAddresses\": {\n    \"OtherBillingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherShippingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherCustomerAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ]\n  },\n  \"PaymentSettings\": {\n    \"PaymentMethodId\": 123,\n    \"Discount\": 123,\n    \"PaymentTarget\": 123,\n    \"CreditLimit\": 123,\n    \"StopPaymentRequest\": true\n  },\n  \"CustomerSince\": \"2023-11-07T05:31:56Z\",\n  \"LastChange\": \"2023-11-07T05:31:56Z\",\n  \"CustomerCategoryId\": 123,\n  \"TaxIdentificationNumber\": \"<string>\",\n  \"AccountsReceivableNumber\": 123,\n  \"CommercialRegisterNumber\": \"<string>\",\n  \"Website\": \"<string>\",\n  \"InitialContact\": \"<string>\",\n  \"EbayUsername\": \"<string>\",\n  \"Birthday\": \"2023-11-07T05:31:56Z\",\n  \"IsLocked\": true,\n  \"IsCashRegisterBased\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jtl-cloud.com/erp/v1/customers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-tenant-id"] = '<x-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"CustomerGroupId\": 123,\n  \"BillingAddress\": {\n    \"City\": \"<string>\",\n    \"CountryIso\": \"<string>\",\n    \"Company\": \"<string>\",\n    \"Company2\": \"<string>\",\n    \"FormOfAddress\": \"<string>\",\n    \"Title\": \"<string>\",\n    \"FirstName\": \"<string>\",\n    \"LastName\": \"<string>\",\n    \"Street\": \"<string>\",\n    \"Address2\": \"<string>\",\n    \"PostalCode\": \"<string>\",\n    \"State\": \"<string>\",\n    \"VatID\": \"<string>\",\n    \"PhoneNumber\": \"<string>\",\n    \"MobilePhoneNumber\": \"<string>\",\n    \"EmailAddress\": \"<string>\",\n    \"Fax\": \"<string>\"\n  },\n  \"LanguageIso\": \"<string>\",\n  \"InternalCompanyId\": 123,\n  \"Number\": \"<string>\",\n  \"OtherAddresses\": {\n    \"OtherBillingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherShippingAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ],\n    \"OtherCustomerAddresses\": [\n      {\n        \"City\": \"<string>\",\n        \"CountryIso\": \"<string>\",\n        \"Company\": \"<string>\",\n        \"Company2\": \"<string>\",\n        \"FormOfAddress\": \"<string>\",\n        \"Title\": \"<string>\",\n        \"FirstName\": \"<string>\",\n        \"LastName\": \"<string>\",\n        \"Street\": \"<string>\",\n        \"Address2\": \"<string>\",\n        \"PostalCode\": \"<string>\",\n        \"State\": \"<string>\",\n        \"VatID\": \"<string>\",\n        \"PhoneNumber\": \"<string>\",\n        \"MobilePhoneNumber\": \"<string>\",\n        \"EmailAddress\": \"<string>\",\n        \"Fax\": \"<string>\"\n      }\n    ]\n  },\n  \"PaymentSettings\": {\n    \"PaymentMethodId\": 123,\n    \"Discount\": 123,\n    \"PaymentTarget\": 123,\n    \"CreditLimit\": 123,\n    \"StopPaymentRequest\": true\n  },\n  \"CustomerSince\": \"2023-11-07T05:31:56Z\",\n  \"LastChange\": \"2023-11-07T05:31:56Z\",\n  \"CustomerCategoryId\": 123,\n  \"TaxIdentificationNumber\": \"<string>\",\n  \"AccountsReceivableNumber\": 123,\n  \"CommercialRegisterNumber\": \"<string>\",\n  \"Website\": \"<string>\",\n  \"InitialContact\": \"<string>\",\n  \"EbayUsername\": \"<string>\",\n  \"Birthday\": \"2023-11-07T05:31:56Z\",\n  \"IsLocked\": true,\n  \"IsCashRegisterBased\": true\n}"

response = http.request(request)
puts response.read_body

{
  "Id": 123,
  "Number": "<string>",
  "CustomerGroupId": 123,
  "BillingAddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "Shipmentaddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "CustomAddress": {
    "Id": 123,
    "Company": "<string>",
    "Company2": "<string>",
    "FormOfAddress": "<string>",
    "Title": "<string>",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Street": "<string>",
    "Address2": "<string>",
    "PostalCode": "<string>",
    "City": "<string>",
    "State": "<string>",
    "CountryIso": "<string>",
    "VatID": "<string>",
    "PhoneNumber": "<string>",
    "MobilePhoneNumber": "<string>",
    "EmailAddress": "<string>",
    "Fax": "<string>"
  },
  "OtherAddresses": {
    "OtherBillingAddresses": [
      {
        "Id": 123,
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "City": "<string>",
        "State": "<string>",
        "CountryIso": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherShippingAddresses": [
      {
        "Id": 123,
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "City": "<string>",
        "State": "<string>",
        "CountryIso": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ],
    "OtherCustomerAddresses": [
      {
        "Id": 123,
        "Company": "<string>",
        "Company2": "<string>",
        "FormOfAddress": "<string>",
        "Title": "<string>",
        "FirstName": "<string>",
        "LastName": "<string>",
        "Street": "<string>",
        "Address2": "<string>",
        "PostalCode": "<string>",
        "City": "<string>",
        "State": "<string>",
        "CountryIso": "<string>",
        "VatID": "<string>",
        "PhoneNumber": "<string>",
        "MobilePhoneNumber": "<string>",
        "EmailAddress": "<string>",
        "Fax": "<string>"
      }
    ]
  },
  "PaymentSettings": {
    "PaymentMethodId": 123,
    "Discount": 123,
    "PaymentTarget": 123,
    "CreditLimit": 123,
    "StopPaymentRequest": true
  },
  "CustomerSince": "2023-11-07T05:31:56Z",
  "LastChange": "2023-11-07T05:31:56Z",
  "LanguageIso": "<string>",
  "InternalCompanyId": 123,
  "CustomerCategoryId": 123,
  "TaxIdentificationNumber": "<string>",
  "AccountsReceivableNumber": 123,
  "CommercialRegisterNumber": "<string>",
  "Website": "<string>",
  "InitialContact": "<string>",
  "EbayUsername": "<string>",
  "Birthday": "2023-11-07T05:31:56Z",
  "IsLocked": true,
  "IsCashRegisterBased": true
}

{
  "ErrorCode": "<string>",
  "ValidationErrors": {},
  "Errors": {},
  "ErrorMessage": "<string>",
  "Stacktrace": "<string>"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-runas

string

The User-Id (int or uuid) on whose behalf the request is executed. Requires scope 'Application.RunAs'.

x-tenant-id

string<uuid>

required

The tenant ID for the target ERP instance.

Query Parameters

disableAutomaticWorkflows

boolean

If true, the workflows do not trigger automatic.

Body

application/json

The customer to create.

Model Class: CreateCustomer

CustomerGroupId

integer<int32>

required

The customer group ID.

BillingAddress

object

required

The customer's default billing address.

Show child attributes

LanguageIso

string

required

The customer's language.

InternalCompanyId

integer<int32>

required

The internal ID of the company associated with the customer. This is configured in the company and email settings in JTL-Wawi

Number

string

The customer's number.

Shipmentaddress

object

The customer's default shipping address.

Show child attributes

CustomAddress

object

The customer's default non-billing and non-shipping address.

Show child attributes

OtherAddresses

object

All other non-default addresses of the customer.

Show child attributes

PaymentSettings

object

The payment settings for the customer.

Show child attributes

CustomerSince

string<date-time>

Date since they have been a customer.

LastChange

string<date-time>

Date of the last customer's data change.

CustomerCategoryId

integer<int32>

The customer category ID.

TaxIdentificationNumber

string

The customer's tax identification number.

AccountsReceivableNumber

integer<int32>

The customer's accounts receivable number.

CommercialRegisterNumber

string

The customer's commercial register number.

Website

string

The customer's website.

InitialContact

string

The source of initial contact. This could be for example a specific sales channel, a convention or a marketing campaign.

EbayUsername

string

The customer's eBay username.

Birthday

string<date-time>

The customer's date of birth.

IsLocked

boolean

The customer's locked status for online shop sales channels.

IsCashRegisterBased

boolean

States if a customer is from a cash-register or point of sale and if their data should be synchronized with JTL-POS, for example.

Response

The created customer.

Model Class: Customer

integer<int32>

required

Unique ID to identify a customer.

Number

string

required

The customer's number.

CustomerGroupId

integer<int32>

required

The customer group ID.

BillingAddress

object

required

The customer's default billing address.

Show child attributes

Shipmentaddress

object

required

The customer's default shipping address.

Show child attributes

CustomAddress

object

required

The customer's default non-billing and non-shipping address.

Show child attributes

OtherAddresses

object

required

All other non-default addresses of the customer.

Show child attributes

PaymentSettings

object

required

The payment settings for the customer.

Show child attributes

CustomerSince

string<date-time>

required

Date since they have been a customer.

LastChange

string<date-time>

required

Date of the last customer's data change.

LanguageIso

string

required

The customer's language.

InternalCompanyId

integer<int32>

required

The internal ID of the company associated with the customer. This is configured in the company and email settings in JTL-Wawi

CustomerCategoryId

integer<int32>

required

The customer category ID.

TaxIdentificationNumber

string

required

The customer's tax identification number.

AccountsReceivableNumber

integer<int32>

required

The customer's accounts receivable number.

CommercialRegisterNumber

string

required

The customer's commercial register number.

Website

string

required

The customer's website.

InitialContact

string

required

The source of initial contact. This could be for example a specific sales channel, a convention or a marketing campaign.

EbayUsername

string

required

The customer's eBay username.

Birthday

string<date-time>

required

The customer's date of birth.

IsLocked

boolean

required

The customer's locked status for online shop sales channels.

IsCashRegisterBased

boolean

required

States if a customer is from a cash-register or point of sale and if their data should be synchronized with JTL-POS, for example.

Query Customers Get Customer

⌘I

Overview

REST API

Authorizations

Headers

Query Parameters

Body

Response