customer.create

This method is used to create a Customer.

Arguments

This method has the path /customer/v1/customer.create and follows the MicroBase API calling conventions.

Argument Required Type Example Description
email yes String john.doe@gmail.com Customer email.
password yes String mypassword Customer password.
firstName yes String John Customer first name.
lastName yes String Doe Customer last name.
status no String ACTIVE Status of the customer. ACTIVE or INACTIVE.
tags no Array [VIP] Tags associated to the customer.
addresses no Object List - Customer addresses

Addresses

Argument Required Type Example Description
name yes String Work Address name.
firstName yes String John Customer first name.
lastName no String Doe Customer last name.
address_1 yes String 1650 Bolman Court Address information.
address_2 no Array Number 10 Aditional address information.
postCode yes String 61701 Address post code
city yes String Bloomington Address city
state yes String Illinois Address state
country yes String US Address country
company no String My Company Name of the company
phone no Number 2173203531 Address phone
instructions no String Some instructions Aditional instrucctions for the address

Response

Returns a customer object:

{
    "ok": true,
    "customer": {
        "email": "john.doe@gmail.com",
        "firstName": "John",
        "lastName": "Doe",
        "status": "ACTIVE",
        "tags": [
            "VIP"
        ],
        "addresses": [
            {
                "name": "Work",
                "firstName": "John",
                "lastName": "Doe",
                "address_1": "1650 Bolman Court",
                "address_2": "Number 10",
                "postCode": "61701",
                "city": "Bloomington",
                "state": "Illinois",
                "country": "US",
                "company": "My Company",
                "phone": 2173203531,
                "instructions": "Some Instructions",
                "id": "r1h2uQ4rx"
            }
        ],
        "id": "HkhhuXESl"
    }
}

Errors

Expected errors that this method could return. Some errors return additional data.

Error Data Description
duplicate_key Index name and data causing the error Email is unique
validation_error The data causing the error Some validation error
customer_invalid_email The data causing the error Email has an invalid format
address_contry_invalid The data causing the error Address country has an invalid format

Example

curl --request POST \
  --url http://localhost:3005/services/customer/v1/customer.create \
  --header 'authorization: Bearer xxxxx...' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
        "email": "john.doe@gmail.com",
        "password": "mypassword",
        "firstName": "John",
        "lastName": "Doe",
        "tags": ["VIP"],
        "status": "ACTIVE",
        "addresses": [{
          "name": "Work",
          "firstName": "John",
          "lastName": "Doe",
          "address_1": "1650 Bolman Court",
          "address_2": "",
          "postCode": "61701",
          "city": "Bloomington",
          "state": "Illinois",
          "country": "US",
          "company" : "My Company",
          "phone" : 2173203531,
          "instructions" : "Some Instructions"
        }]
      }'