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 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "phone": "+32475123456",
  "email": "john.doe@gmail.com",
  "address": {
    "name": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "street": "Avenue de la République",
    "number": "123",
    "box": "A",
    "country": "FR"
  }
}
'
import requests

url = "https://api.chift.eu/consumers/{consumer_id}/pos/customers"

payload = {
"first_name": "<string>",
"last_name": "<string>",
"phone": "+32475123456",
"email": "john.doe@gmail.com",
"address": {
"name": "<string>",
"city": "<string>",
"postal_code": "<string>",
"street": "Avenue de la République",
"number": "123",
"box": "A",
"country": "FR"
}
}
headers = {"Content-Type": "application/json"}

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

print(response.text)
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
first_name: '<string>',
last_name: '<string>',
phone: '+32475123456',
email: 'john.doe@gmail.com',
address: {
name: '<string>',
city: '<string>',
postal_code: '<string>',
street: 'Avenue de la République',
number: '123',
box: 'A',
country: 'FR'
}
})
};

fetch('https://api.chift.eu/consumers/{consumer_id}/pos/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.chift.eu/consumers/{consumer_id}/pos/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([
'first_name' => '<string>',
'last_name' => '<string>',
'phone' => '+32475123456',
'email' => 'john.doe@gmail.com',
'address' => [
'name' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'street' => 'Avenue de la République',
'number' => '123',
'box' => 'A',
'country' => 'FR'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);

$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.chift.eu/consumers/{consumer_id}/pos/customers"

payload := strings.NewReader("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"phone\": \"+32475123456\",\n \"email\": \"john.doe@gmail.com\",\n \"address\": {\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"street\": \"Avenue de la République\",\n \"number\": \"123\",\n \"box\": \"A\",\n \"country\": \"FR\"\n }\n}")

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

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.chift.eu/consumers/{consumer_id}/pos/customers")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"phone\": \"+32475123456\",\n \"email\": \"john.doe@gmail.com\",\n \"address\": {\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"street\": \"Avenue de la République\",\n \"number\": \"123\",\n \"box\": \"A\",\n \"country\": \"FR\"\n }\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.chift.eu/consumers/{consumer_id}/pos/customers")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"phone\": \"+32475123456\",\n \"email\": \"john.doe@gmail.com\",\n \"address\": {\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"street\": \"Avenue de la République\",\n \"number\": \"123\",\n \"box\": \"A\",\n \"country\": \"FR\"\n }\n}"

response = http.request(request)
puts response.read_body
{
  "id": "<string>",
  "name": "<string>",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+32475123456",
  "email": "john.doe@gmail.com",
  "created_on": "2025-01-01T00:00:00Z",
  "addresses": [],
  "loyalty": 100,
  "birthdate": "1990-01-01"
}
{
"message": "Error while trying to perform your request",
"status": "error"
}
{
"message": "The resource {Method} - {Resource} is not supported by {ConnectorName}",
"status": "error"
}
{
"message": "Validation error",
"status": "error",
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}
{
"message": "Error while trying to authenticate to {ConnectorName}",
"status": "error"
}

Path Parameters

consumer_id
string<uuid>
required

Body

application/json
first_name
string
required

First name of the customer

Minimum string length: 1
Example:

"John"

last_name
string
required

Last name of the customer

Minimum string length: 1
Example:

"Doe"

phone
string | null

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

Example:

"+32475123456"

email
string | null

Email address of the customer

Example:

"john.doe@gmail.com"

address
PostAddressItem · object | null

Address of the customer

Response

Successful Response

id
string
required

Unique identifier of the customer

Example:

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

name
string
required

Name (first name + last name) of the customer

Example:

"John Doe"

first_name
string | null

First name of the customer

Example:

"John"

last_name
string | null

Last name of the customer

Example:

"Doe"

phone
string | null

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

Example:

"+32475123456"

email
string | null

Email address of the customer

Example:

"john.doe@gmail.com"

created_on
string<date-time> | null

Date and time when the customer was created

Example:

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

addresses
AddressItem · object[] | null

List of addresses of the customer

loyalty
integer | null

Loyalty points of the customer

Example:

100

birthdate
string<date> | null

Birthdate of the customer

Example:

"1990-01-01"