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

# POST /subscriptions

`POST /subscriptions`

## Query parameters

- `select` string

## Headers

- `Prefer` 'return=representation' | 'return=minimal' | 'return=none' | 'resolution=ignore-duplicates' | 'resolution=merge-duplicates'

## Request body

- Subscriptions
  - `id` string, text, required — Note: This is a Primary Key.<pk/>
  - `user_id` string, uuid
  - `status` 'trialing' | 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'past_due' | 'unpaid', public.subscription_status
  - `metadata` unknown
  - `price_id` string, text — Note: This is a Foreign Key to `prices.id`.<fk table='prices' column='id'/>
  - `quantity` integer
  - `cancel_at_period_end` boolean
  - `created` string, timestamp with time zone, required
  - `current_period_start` string, timestamp with time zone, required
  - `current_period_end` string, timestamp with time zone, required
  - `ended_at` string, timestamp with time zone
  - `cancel_at` string, timestamp with time zone
  - `canceled_at` string, timestamp with time zone
  - `trial_start` string, timestamp with time zone
  - `trial_end` string, timestamp with time zone
  - `organization_id` string, uuid, required — Note: This is a Foreign Key to `organization.id`.<fk table='organization' column='id'/>

## Response `201`

Created

---

[API](https://skmtc.net/revent-app/apis/standard-public-schema.md) · [All operations](https://skmtc.net/revent-app/apis/standard-public-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revent-app/standard-public-schema/revisions/90ce877204f2/schema)