---
title: "Create Customer"
method: POST
path: "/customers"
tags: ["Customers"]
---

# Create Customer

`POST /customers`

Create a new customer.

## Request body

- CreateCustomerRequest
  - `external_id` string, nullable — The provided `external_id` must be unique. If a non-unique `external_id` is provided, the API will respond with an error.
  - `sales_channel` string, required — If a channel with this name is not already associated with the shop, it will be used to create a new channel.
  - `first_name` string, nullable — The customer's given name.
  - `last_name` string, nullable — The customer's surname.
  - `email` string, email, nullable — The customer's email address.
  - `phone` string, nullable — The customer's phone number.
  - `tags` TagRequestData[], nullable — An array of tags used to classify and group customers.

## Response `201`

Success

- CustomerWrappedResponse
  - `customer` CustomerResponse, required
    - `id` integer, required — The unique identifier for the customer, created by Loop.
    - `external_id` string, nullable — The identifier used by an external source to identify the customer.
    - `sales_channel` string, nullable — The name of the channel associated with the customer.
    - `first_name` string, nullable — The customer's given name.
    - `last_name` string, nullable — The customer's surname.
    - `email` string, email, nullable — The customer's email address.
    - `phone` string, nullable — The customer's phone number.
    - `tags` string[] — An array of tags associated with the customer.

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/loopreturns/apis/listings-api.md) · [All operations](https://skmtc.dev/loopreturns/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loopreturns/listings-api/revisions/750e6012dbb8/schema)