---
title: "Add a new customer tag to the store"
method: POST
path: "/customertags"
tags: ["CustomerTags"]
---

# Add a new customer tag to the store

`POST /customertags`

## Request

- Base URL: `https://api.c1st.com/api`
- URL: `https://api.c1st.com/api/customertags`
- Auth: HTTP bearer

## Request body

- CustomerTag: A customer tag
  - `title` string, required: The title of the tag
  - `id` integer, nullable: The id of the tag
  - `handle` string, nullable: Unique handle for the produttag. Will be set automatically if not set. This value cannot be changed once set.
  - `color` string, nullable: The color used when displaying the tag in the app

## Response `200`

Ok

- CustomerTagsResponse: The customer tags used by a store.
  - `content` CustomerTag[]
    - `title` string, required: The title of the tag
    - `id` integer, nullable: The id of the tag
    - `handle` string, nullable: Unique handle for the produttag. Will be set automatically if not set. This value cannot be changed once set.
    - `color` string, nullable: The color used when displaying the tag in the app
  - `count` integer, nullable: The total number of customer tags found
  - `hasMore` boolean: True if there are data to retrieve than the given page length

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/c1st/apis/customers-1st-api.md) - [All operations](https://skmtc.dev/c1st/apis/customers-1st-api/llms.txt) - [OpenAPI document](https://skmtc.dev/c1st/apis/customers-1st-api/revisions/4250bb326f2a?raw)