---
title: "요금제 구독 시작"
method: POST
path: "/users/{userId}/subscription"
tags: ["OAUTH APPLICATION API"]
---

# 요금제 구독 시작

`POST /users/{userId}/subscription`

특정 유저에게 리셀러 요금제를 구독 시작시킵니다.

`해당 API는 인증된 파트너 고객사에게 제공됩니다.`

## Path parameters

- `userId` string, required

## Request body

- CreateSubscriptionRequestDto
  - `clientId` string, required — 클라이언트 ID
  - `clientSecret` string, required — 클라이언트 비밀번호
  - `planId` string, required — 요금제 ID

## Response `201`

- CreateSubscriptionResponseDto
  - `status` string, required — 구독 상태
  - `resetDateOfMonth` number, required — 구독의 매월 갱신일
  - `userId` string, required — 유저의 고유 ID
  - `isSubscribing` boolean, required — 구독의 갱신 유지 여부
  - `nextResetDate` string, date-time, required — 구독의 다음 갱신일
  - `plan` Plan, required
    - `id` string, required — 요금제의 고유 ID
    - `title` string, required — 요금제 이름
    - `resetPeriod` ResetPeriod, required
      - `value` number, required — 갱신 주기
      - `unit` 'MONTH', required — 갱신 단위

---

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