---
title: "Create subscription"
method: POST
path: "/v1/subscriptions"
tags: ["Subscriptions"]
---

# Create subscription

`POST /v1/subscriptions`

## Headers

- `idempotency-key` string

## Request body

- CreateSubscriptionRequest
  - `planCode` string, required
  - `customer` string, email, required
  - `card` string
  - `startDate` string
  - `paymentMethod` 'card' | 'mobile_money' | 'bank_transfer' | 'bank' — Use card for card auto-collection. Use mobile_money, bank_transfer, or bank for invoice-based collection where the customer completes payment through generated payment instructions or a payment link.
  - `redirectUrl` string
  - `invoiceLimit` number
  - `maxRetryCount` number
  - `gracePeriodDays` number

## Response `201`

Subscription.

- GenericResponse
  - `status` boolean
  - `message` string
  - `code` integer
  - `data` unknown

---

[API](https://skmtc.net/kyshi/apis/kyshi-mor-public-api.md) · [All operations](https://skmtc.net/kyshi/apis/kyshi-mor-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyshi/kyshi-mor-public-api/versions/3c46fabe8df7/schema)