---
title: "Creates a new entitlement in this account"
method: POST
path: "/accounts/{id}/entitlements"
tags: ["entitlements"]
---

# Creates a new entitlement in this account

`POST /accounts/{id}/entitlements`

Creates a new entitlement and returns the definition

## Path parameters

- `id` string, required

## Request body

- EntitlementPost — The configurable parts of an entitlement
  - `plan_id` string — Api ID of the associated plan
  - `started` union
    - unknown
    - string — An iso8601 formatted timestamp

## Response `200`

The entitlements was successfully created

- Entitlement — The current state of an entitlement
  - `plan_id` string — Api ID of the associated plan
  - `started` union
    - unknown
    - string — An iso8601 formatted timestamp
  - `href` string — A reference to this entitlement
  - `created` string — An iso8601 formatted timestamp

---

[API](https://skmtc.dev/webscale/apis/webscale-apis.md) · [All operations](https://skmtc.dev/webscale/apis/webscale-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webscale/webscale-apis/revisions/c98d872b50cb/schema)