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

# Create a subscription

`POST /v1/subscriptions`

Create a recurring billing subscription for a customer.

## Request body

- object
  - `customerId` string, required — Customer ID
  - `name` string, required — Subscription name
  - `description` string — Optional description
  - `interval` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'ANNUAL', required — Billing interval
  - `priceUsdc` number, required — Price per interval in USDC
  - `metadata` object — Custom metadata
  - `trialDays` integer — Trial period in days (1-365)
  - `includedUsage` integer — Included usage units per period
  - `overageUnitType` string — Usage type for overage metering

## Response `201`

Subscription created

- object — Subscription created

## Other responses

- `401` — Unauthorized
- `404` — Customer not found
- `422` — Validation error

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/revisions/2cb1567969ca/schema)