---
title: "Create a new customer"
method: POST
path: "/customers"
tags: ["Customers"]
---

# Create a new customer

`POST /customers`

Create a new customer for a merchant

## Query parameters

- `createOrUpdate` boolean

## Request body

- CustomerObject
  - `id` string, uuid — unique uuid of the customer
  - `name` string — customer's full name
  - `phone` string — customer's mobile phone number.
  - `email` string — the email of the customer
  - `address` string — Full street address, which MAY include house number, street name, Post Office Box, etc
  - `city` string — City or locality component.
  - `postalCode` string — Zip code or postal code component.
  - `country` string, required — ISO3166-1 alpha-2 two letter, uppercase.
  - `locale` string — User locale, language is lower case. Country in upper case
  - `createdAt` string — The date time that record was created in our system.
  - `updatedAt` string — The date time that record was updated in our system.

## Response `201`

The customer is added successfully

## Other responses

- `400` — Bad Request
- `401` — The caller is not authenticated
- `403` — Access rights not sufficient
- `500` — Internal Server Error.

---

[API](https://skmtc.dev/bictorys/apis/pay.md) · [All operations](https://skmtc.dev/bictorys/apis/pay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bictorys/pay/revisions/b85cce14340b/schema)