---
title: "POST /v1/subscription-plans"
method: POST
path: "/v1/subscription-plans"
tags: ["SubscriptionPlans"]
---

# POST /v1/subscription-plans

`POST /v1/subscription-plans`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/subscription-plans`
- Auth: API key in header `x-api-key`

## Request body

- CreateSubscriptionPlanRequestDto
  - `id` string, required: Subscription plan ID
  - `name` string, required: Subscription plan name
  - `stripeProductId` string, required: Stripe product ID
  - `features` object, required: Legacy feature configuration
  - `featureIds` string[]: Enabled feature IDs
  - `limitTransactions` integer, required: Transaction limit
  - `limitUsers` integer, required: User limit
  - `limitPortfolios` integer, required: Portfolio limit
  - `limitWallets` integer, required: Wallet limit
  - `isAutoUpdateEnabled` boolean: Whether auto-update is enabled
  - `isPublic` boolean: Whether the plan is offered publicly on pricing and /subscribe
  - `canUpgrade` boolean: Whether workspaces on this plan are shown an upgrade path

## Response `201`

- SubscriptionPlanResponseDto
  - `id` string, required: Subscription plan ID
  - `name` string, required: Subscription plan name
  - `stripeProductId` string, required: Stripe product ID
  - `features` object, required: Legacy feature configuration
  - `featureIds` string[], required: Enabled feature IDs
  - `limitTransactions` integer, required: Transaction limit
  - `limitUsers` integer, required: User limit
  - `limitPortfolios` integer, required: Portfolio limit
  - `limitWallets` integer, required: Wallet limit
  - `isAutoUpdateEnabled` boolean, required: Whether auto-update is enabled
  - `isPublic` boolean, required: Whether the plan is offered publicly on pricing and /subscribe
  - `canUpgrade` boolean, required: Whether workspaces on this plan are shown an upgrade path
  - `createdAt` string, date-time, required: Creation timestamp (ISO 8601)
  - `updatedAt` string, date-time, required: Last update timestamp (ISO 8601)

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)