To create a new customer the client needs to send a HTTP <code>POST</code> request on the customer collection resource URI <code>https://api.example.com/v1/customers</code> (also see [[Application_Programming_Interface_(API)#Base_URI|Base URI]]), including the associated customer informations.
The service will generate a new customer and responds with a HTTP status code <code>201</code> (Created) on success. The newly created customer URI is returned within the HTTP location header, which can be used by the client to gather informations about the new customer.
We have two types of customers:
* '''Company customer''': where we actually have a proper company or business name.
* '''Private customer''': where we have the given name and the surname of the customer.
=== Customer creation request message ===