---
title: "Create an entitlement set"
method: POST
path: "/v3/entitlement-sets"
tags: ["EntitlementSets"]
---

# Create an entitlement set

`POST /v3/entitlement-sets`

Creates a new entitlement set.

## Request body

- EntitlementSetCreateRequestModel
  - `name` string, required — Letters (a-z, A-Z), numbers, underscores, hyphens and dots.
  - `displayName` string, required — Any printable characters, including letters from any script, punctuation and emoji. Cannot contain line breaks, tabs, other control characters, invisible formatting characters (zero-width and bidirectional marks), and cannot start or end with whitespace.
  - `description` string, nullable — Any printable characters and line breaks. Cannot contain control characters other than tab, carriage return and line feed, nor invisible formatting characters (zero-width and bidirectional marks), and cannot start or end with whitespace.
  - `productIds` string[], required
  - `tier` integer, nullable

## Response `201`

Created

- EntitlementSetDto
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `name` string, required
  - `displayName` string, required
  - `description` string, nullable
  - `tier` integer, required
  - `productIds` string[], nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `429` — Too Many Requests
- `500` — Server Error

## Changes

- **2026-08-18** `66dcb6293180` — 3 breaking
  - added the pattern `^(?!\s)(?!.*\s$)[^\p{Cc}\p{Cf}\p{Zl}\p{Zp}]+$` to the request property `displayName`
  - added the pattern `^(?!\s)(?![\s\S]*\s$)(?:[^\p{Cc}\p{Cf}\p{Zl}\p{Zp}]|[\t\n\r])+$` to the request property `description`
  - added the pattern `^[a-zA-Z0-9_.-]+$` to the request property `name`

[Change history](https://skmtc.dev/cryptlex/apis/cryptlex-web-api/changes/v3/entitlement-sets/post.md)

---

[API](https://skmtc.dev/cryptlex/apis/cryptlex-web-api.md) · [All operations](https://skmtc.dev/cryptlex/apis/cryptlex-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cryptlex/cryptlex-web-api/revisions/66dcb6293180/schema)