---
title: "Create one customer"
method: POST
path: "/consumers/{consumer_id}/pos/customers"
tags: ["Point of Sale", "Customers"]
---

# Create one customer

`POST /consumers/{consumer_id}/pos/customers`

Create a customer

## Path parameters

- `consumer_id` string, uuid, required

## Request body

- POSCreateCustomerItem
  - `first_name` string, required — First name of the customer
  - `last_name` string, required — Last name of the customer
  - `phone` string, nullable — Phone number (mobile, home, work, ...) of the customer
  - `email` string, nullable — Email address of the customer
  - `address` PostAddressItem
    - `name` string, required — Name given to the address (e.g. 'home')
    - `street` string, nullable — Street name
    - `number` string, nullable — Number of the address
    - `box` string, nullable — Box of the address
    - `city` string, required — City name
    - `postal_code` string, required — Postal code of the address
    - `country` string, nullable — Country, format: ISO 3166-1 codes.

## Response `200`

Successful Response

- POSCustomerItem
  - `id` string, required — Unique identifier of the customer
  - `first_name` string, nullable — First name of the customer
  - `last_name` string, nullable — Last name of the customer
  - `name` string, required — Name (first name + last name) of the customer
  - `phone` string, nullable — Phone number (mobile, home, work, ...) of the customer
  - `email` string, nullable — Email address of the customer
  - `created_on` string, date-time, nullable — Date and time when the customer was created
  - `addresses` AddressItem[], nullable — List of addresses of the customer
    - `address_type` string, nullable — Type of the address
    - `name` string, nullable — Name given to the address (e.g. 'home')
    - `street` string, nullable — Street name
    - `number` string, nullable — Number of the address
    - `box` string, nullable — Box of the address
    - `city` string, nullable — City name
    - `postal_code` string, nullable — Postal code of the address
    - `country` string, nullable — Country, format: ISO 3166-1 codes.
  - `loyalty` integer, nullable — Loyalty points of the customer
  - `birthdate` string, date, nullable — Birthdate of the customer

## Other responses

- `400` — Bad Request
- `405` — Method Not Allowed
- `422` — Validation Error
- `502` — Bad Gateway

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/revisions/b5f1214a482a/schema)
