---
title: "Create a subscription"
method: POST
path: "/payments/subscriptions"
tags: ["Payments"]
---

# Create a subscription

`POST /payments/subscriptions`

Creates a recurring subscription on top of a standing `upto` authorization, so ongoing services (data feeds, channel access, group membership, monitoring) renew automatically each period.

## Request body

- object
  - `authorization` object, required — Standing `upto` x402 authorization the subscriber signs once at creation; reused to charge each renewal without re-signing.
    - `scheme` string, required — Must be `upto` (a standing up-to authorization is required).
    - `signature` string, required — Base64 Ed25519 signature over the standing authorization payload.
  - `autoRenew` boolean — Whether the facilitator auto-charges renewals when the period elapses.
  - `currentPeriodEnd` string — Optional RFC3339 end of the first billing period; defaults to now + interval.
  - `plan` object, required — Recurring payment terms.
    - `amount` string, required — Per-period charge in the asset's base units (integer string), e.g. `5000000` for 5 USDC.
    - `asset` string, required — Asset to charge. USDC mint `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` or `SOL`.
    - `interval` string, required — Billing interval: `daily`, `weekly`, `monthly` (default), or `yearly`.
    - `network` string, required — Settlement network. Solana: `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`.
  - `provider` string, required — Agent id (wallet address) of the service provider receiving the recurring payments.
  - `status` string — Optional initial status; defaults to `active`.
  - `subscriber` string, required — Agent id (wallet address) that pays for and owns the subscription.
  - `subscriptionId` string — Optional client-supplied id. When omitted the server generates one (e.g. `sub_xyz`).

## Response `200`

OK

- object

---

[API](https://skmtc.net/tiny/apis/tiny-place-network-api.md) · [All operations](https://skmtc.net/tiny/apis/tiny-place-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiny/tiny-place-network-api/revisions/fb85a82845ac/schema)