---
title: "Create license type"
method: POST
path: "/license_types"
tags: ["LicenseType"]
---

# Create license type

`POST /license_types`

This endpoint is used to create a new license type.

License types are used to group licenses and define billing behavior. Each license type has a name and a
grouping key that determines how metrics are aggregated for billing purposes.

## Request body

- NewLicenseType
  - `name` string, required — The name of the license type.
  - `grouping_key` string, required — The key used for grouping licenses of this type. This is typically a user identifier field.

## Response `201`

Created

- LicenseType — The LicenseType resource represents a type of license that can be assigned to users. License types are used during billing by grouping metrics on the configured grouping key.
  - `id` string, required — The Orb-assigned unique identifier for the license type.
  - `name` string, required — The name of the license type.
  - `grouping_key` string, required — The key used for grouping licenses of this type. This is typically a user identifier field.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `413` — Content Too Large
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/withorb/apis/api-reference.md) · [All operations](https://skmtc.dev/withorb/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withorb/api-reference/revisions/816dfe734e2e/schema)