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

# Create subscription

`POST /subscriptions`

Creates a recurring payment subscription. The first order is created immediately;
subsequent orders are triggered on the defined schedule.

## Request body

- object
  - `buyer_id` integer, required — Customer ID of the subscriber (buyer).
  - `seller_id` integer, required — Customer ID of the seller.
  - `name` string, required
  - `value` number, required — Recurring charge amount.
  - `type` string, required — Payment method type for the subscription (e.g. `CARD`).
  - `fee_value` number
  - `fee_percent` number
  - `start_date` string, date — Date when the subscription starts. Defaults to creation date if not provided.
  - `first_payment_value` number — Amount for the first payment if different from `value`.
  - `times` integer — Number of billing cycles. Leave null for indefinite.
  - `schedule` string — Cron expression or schedule descriptor (e.g. `monthly`, `weekly`).
  - `auto_settle` boolean
  - `tag` string
  - `metadata` object
  - `order_metadata` object — Metadata applied to each generated order.
  - `buyer_confirmed_url` string, uri
  - `buyer_denied_url` string, uri
  - `seller_confirmed_url` string, uri
  - `seller_denied_url` string, uri

## Response `200`

Subscription created

- Subscription
  - `id` integer
  - `self` string
  - `reference_id` string, nullable
  - `name` string
  - `amount` number
  - `currency` string
  - `type` string — Payment method type for this subscription.
  - `status` 'CREATED' | 'ACTIVE' | 'CANCELLED' | 'EXPIRED'
  - `metadata` object, nullable
  - `published_at` string, date-time, nullable
  - `cancelled_at` string, date-time, nullable
  - `connections` Connections — Hypermedia links to related resources.

## Other responses

- `422` — Validation error

---

[API](https://skmtc.net/truust-io/apis/truust-api.md) · [All operations](https://skmtc.net/truust-io/apis/truust-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truust-io/truust-api/versions/cc81e28726b9/schema)