---
title: "Create Enterprise Subscription"
method: POST
path: "/api/v1/admin/stripe-subscriptions"
tags: ["Admin APIs", "stripe-subscriptions"]
---

# Create Enterprise Subscription

`POST /api/v1/admin/stripe-subscriptions`

Create a Stripe subscription for enterprise client onboarding.

Supports multiple line items, trial periods, and billing controls.
Automatically attaches client_id and product_id metadata.

## Request body

- EnterpriseSubscriptionCreate — Schema for creating an enterprise Stripe subscription with multiple products.
  - `client_id` string, uuid, required — CAMS client UUID — used to look up Stripe customer and auto-populate metadata
  - `product_id` string, uuid, nullable — CAMS product UUID for metadata. If omitted, defaults to the platform (Insights Platform) product.
  - `items` EnterpriseSubscriptionLineItem[], required — One or more line items (price + quantity)
    - `price` string, required — Stripe price ID
    - `quantity` integer
  - `subscription_start_date` string, date-time, nullable — When the subscription period begins (Duration in Stripe)
  - `billing_start_date` string, date-time, nullable — When billing starts (used as trial_end — supports dates beyond 30 days)
  - `cancel_at` string, date-time, nullable — Scheduled cancellation date
  - `trial_period_days` integer, nullable
  - `collection_method` 'charge_automatically' | 'send_invoice', nullable
  - `days_until_due` integer, nullable — Days until invoice due (defaults to 30 for send_invoice)
  - `payment_behavior` 'default_incomplete' | 'allow_incomplete' | 'error_if_incomplete', nullable

## Response `200`

Successful Response

- EnterpriseSubscriptionResponse
  - `id` string, required
  - `customer` string, nullable
  - `status` string, nullable
  - `current_period_start` integer, nullable
  - `current_period_end` integer, nullable
  - `cancel_at` integer, nullable
  - `trial_end` integer, nullable
  - `collection_method` string, nullable
  - `metadata` object
  - `items` object[]
  - `livemode` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)