---
title: "Create a tag"
method: POST
path: "/tags"
tags: ["Tags"]
---

# Create a tag

`POST /tags`

## Request

- Base URL: `https://public-api.alternativepayments.io`
- URL: `https://public-api.alternativepayments.io/tags`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/oauth/token` scopes: `tags:write`

Create a custom tag that can be applied to customers.

## Request body

- CreateTagBody
  - `color` 'aqua_blue' | 'dark_grey' | 'grey' | 'green' | 'red' | 'orange' | 'yellow' | 'purple'
  - `description` string
  - `name` string

## Response `201`

Created

- TagReply
  - `color` string
  - `customer_count` integer
  - `description` string
  - `id` string
  - `name` string
  - `partner_id` string
  - `type` string

## Other responses

- `400`: Bad Request
- `409`: Conflict

## Changes

- **2026-10-20** `7b8246f9fc1c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alternativepayments/apis/alternative-payments/changes/tags/post.md)

---

[API](https://skmtc.dev/alternativepayments/apis/alternative-payments.md) - [All operations](https://skmtc.dev/alternativepayments/apis/alternative-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/alternativepayments/apis/alternative-payments/revisions/281251358a5b?raw)