---
title: "Create Code"
method: POST
path: "/codes"
tags: ["codes"]
---

# Create Code

`POST /codes`

## Request

- Base URL: `https://api.b2metric.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.b2metric.com/codes`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- RedeemCodeCreate
  - `kind` string, required
  - `app` string, required
  - `plan` string, required
  - `seats` integer, required
  - `discount_percent` integer, nullable
  - `max_redemptions` integer
  - `expires_at` string, date-time, nullable

## Response `201`

Successful Response

- RedeemCodeOut
  - `id` string, uuid, required
  - `code` string, required
  - `kind` string, required
  - `app` string, required
  - `plan` string, required
  - `seats` integer, required
  - `discount_percent` integer, nullable
  - `max_redemptions` integer, required
  - `times_redeemed` integer, required
  - `expires_at` string, date-time, nullable
  - `status` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/b2metric/apis/b2metric-license-api.md) - [All operations](https://skmtc.dev/b2metric/apis/b2metric-license-api/llms.txt) - [OpenAPI document](https://skmtc.dev/b2metric/apis/b2metric-license-api/revisions/5c26e11e8b53?raw)
