---
title: "POST /subscriptions"
method: POST
path: "/subscriptions"
tags: ["SubscriptionController"]
---

# POST /subscriptions

`POST /subscriptions`

| Permissions |
| ------- |
| 7001   |

## Request body

- NewSubscription — (tsType: Omit<Subscription, 'id' | 'startDate' | 'endDate'>, schemaOptions: { title: 'NewSubscription', exclude: [ 'id', 'startDate', 'endDate' ] })
  - `deleted` boolean
  - `deletedOn` string, date-time, nullable
  - `deletedBy` string, nullable
  - `createdOn` string, date-time
  - `modifiedOn` string, date-time
  - `createdBy` string
  - `modifiedBy` string
  - `subscriberId` string, required
  - `status` 0 | 1 | 2 | 3 | 4, required — status of the subscription, it can be - 0(pending), 1(active), 2(inactive), 3(cancelled) and 4(expired)
  - `planId` string — plan id of the subscription
  - `invoiceId` string — invoice id of the subscription

## Response `200`

Subscription model instance

- Subscription
  - `deleted` boolean
  - `deletedOn` string, date-time, nullable
  - `deletedBy` string, nullable
  - `createdOn` string, date-time
  - `modifiedOn` string, date-time
  - `createdBy` string
  - `modifiedBy` string
  - `id` string
  - `subscriberId` string, required
  - `startDate` string, required
  - `endDate` string, required
  - `status` 0 | 1 | 2 | 3 | 4, required — status of the subscription, it can be - 0(pending), 1(active), 2(inactive), 3(cancelled) and 4(expired)
  - `planId` string — plan id of the subscription
  - `invoiceId` string — invoice id of the subscription

---

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