Skip to main content
POST
/
consumers
/
{consumer_id}
/
pos
/
customers
Create one customer
curl --request POST \
  --url https://api.chift.eu/consumers/{consumer_id}/pos/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+32475123456",
  "email": "john.doe@gmail.com",
  "address": {
    "name": "home",
    "street": "Avenue de la République",
    "number": "123",
    "box": "A",
    "city": "Paris",
    "postal_code": "75000",
    "country": "FR"
  }
}'
{
  "id": "371ca583-d218-8000-b236-397532cf0e52",
  "first_name": "John",
  "last_name": "Doe",
  "name": "John Doe",
  "phone": "+32475123456",
  "email": "john.doe@gmail.com",
  "created_on": "2025-01-01T00:00:00Z",
  "addresses": [
    {
      "address_type": "home",
      "name": "Home",
      "street": "Main Street",
      "number": "123",
      "box": "A",
      "city": "Paris",
      "postal_code": "75000",
      "country": "FR"
    }
  ],
  "loyalty": 100,
  "birthdate": "1990-01-01"
}

Authorizations

​
Authorization
string
header
required

This access token needs to be included in each of your request to the Chift API.

Path Parameters

​
consumer_id
string<uuid>
required

Body

application/json
​
first_name
string
required

First name of the customer

Minimum length: 1
Examples:

"John"

​
last_name
string
required

Last name of the customer

Minimum length: 1
Examples:

"Doe"

​
phone
string | null

Phone number (mobile, home, work, ...) of the customer

Examples:

"+32475123456"

​
email
string | null

Email address of the customer

Examples:

"john.doe@gmail.com"

​
address
object | null

Address of the customer

Response

Successful Response

​
id
string
required

Unique identifier of the customer

Examples:

"371ca583-d218-8000-b236-397532cf0e52"

​
name
string
required

Name (first name + last name) of the customer

Examples:

"John Doe"

​
first_name
string | null

First name of the customer

Examples:

"John"

​
last_name
string | null

Last name of the customer

Examples:

"Doe"

​
phone
string | null

Phone number (mobile, home, work, ...) of the customer

Examples:

"+32475123456"

​
email
string | null

Email address of the customer

Examples:

"john.doe@gmail.com"

​
created_on
string<date-time> | null

Date and time when the customer was created

Examples:

"2025-01-01T00:00:00Z"

​
addresses
AddressItem · object[] | null

List of addresses of the customer

​
loyalty
integer | null

Loyalty points of the customer

Examples:

100

​
birthdate
string<date> | null

Birthdate of the customer

Examples:

"1990-01-01"