---
title: "Create Metered Subscription"
method: POST
path: "/api/v2/metered_subscriptions"
tags: ["Metered Subscriptions"]
---

# Create Metered Subscription

`POST /api/v2/metered_subscriptions`

Create a new metered subscription linking a METERED product to an organization consumer. The subscription is active immediately when its start time is reached. Usage can begin as soon as the subscription exists, and billing will use the subscription's billable window.

## Request body

- MeteredSubscriptionCreateRequest — Request to create a metered subscription. Price per unit comes from product.price (currently FIXED_PER_UNIT).
  - `product_id` string, uuid, required — METERED product ID (product.price is the price per unit)
  - `organization_consumer_id` string, uuid, required — Organization consumer ID
  - `starts_at` string, date-time, nullable — When subscription becomes effective (defaults to now)
  - `ends_at` string, date-time, nullable — When subscription expires (null = no expiry)

## Response `200`

Successful Response

- MeteredSubscriptionResponse — Response for metered subscription.
  - `id` string, uuid
  - `product_id` string, uuid
  - `organization_consumer_id` string, uuid
  - `organization_id` string, uuid
  - `starts_at` string, date-time
  - `ends_at` string, date-time, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/streampay/apis/stream-app.md) · [All operations](https://skmtc.dev/streampay/apis/stream-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streampay/stream-app/revisions/515eeea7d260/schema)