Create a new customer.

post

https://sandbox.billwerk.com/api/v1/customers

If you only want to create a customer upon successful signup order please use POST /Orders instead.

Body Params

ExternalCustomerId

string | null

Unique external Id, e.g. foreign key

DebitorAccount

string | null

CompanyName

string | null

Customers company name

FirstName

string | null

Customers first name

LastName

string | null

Customers last name

VatId

string | null

Will be validated if given

EInvoicingId

string | null

Customer e-invoicing ID

EInvoicingNetworkId

string | null

Customer e-invoicing network ID

EmailAddress

string | null

Customers emailaddress

AdditionalEmailAddresses

array of objects | null

Customers additional emailaddresses

AdditionalEmailAddresses

PhoneNumber

string | null

Customers phonenumber

Notes

string | null

Customers notes

Tag

string | null

Customers tag

Address

object

AdditionalAddresses

array of objects | null

Customers additional addresses

AdditionalAddresses

Locale

string | null

Customers locale

DestinationCountry

string | null

The 2-letter ISO country code in capital letters, e.g. DE

CustomFields

object | null

Customers customfields

DefaultBearerMedium

string

enum

Enumerates the available media for documents.

Allowed:

BirthDate

date | null

The birthdate. The date must be between January 1, 1900, and yesterday's date. Optional.

VatIdValidationStatus

string

enum

Allowed:

InvoiceAttachmentFormat

string

enum

Allowed:

LastValidationDate

date-time | null

Date of last validation if VAT ID is given

BuyerReference

string | null

Used to identify the invoice recipient

EntityUseCode

string | null

Entity use code is used for tax exemption in external tax services

Responses

401

Unauthorized

409

Conflict

Language

Credentials

Header

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created