---
title: "Create an entitlement definition"
method: POST
path: "/entitlements"
tags: ["Entitlements"]
---

# Create an entitlement definition

`POST /entitlements`

Creates a new entitlement definition for the authenticated project.

## Request body

- V4EntitlementDefinitionCreate
  - `id` string, required — Unique entitlement identifier.
  - `description` string, nullable — Human-readable description of the entitlement.
  - `product_ids` string[], nullable — List of product IDs to associate with this entitlement.

## Response `201`

Created entitlement definition.

- V4EntitlementDefinition
  - `object` 'entitlement', required
  - `id` string, required — Unique entitlement identifier.
  - `url` string, required — Canonical API path.
  - `description` string, nullable — Human-readable description of the entitlement.
  - `product_ids` string[], nullable — List of product IDs associated with this entitlement.
  - `created_at` string, date-time, required — Creation timestamp (ISO 8601 UTC).
  - `updated_at` string, date-time, required — Last update timestamp (ISO 8601 UTC).

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `409` — Entitlement already exists
- `415` — Unsupported Content-Type
- `422` — Unprocessable entity
- `500` — Internal error

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)