---
title: "New User Subscription"
method: POST
path: "/subscriptions/create_user_subscription/"
tags: ["Subscriptions"]
---

# New User Subscription

`POST /subscriptions/create_user_subscription/`

## Request

- Base URL: `http://api.cannoli.app/api/v1`
- URL: `http://api.cannoli.app/api/v1/subscriptions/create_user_subscription/`
- Auth: none declared

This endpoint creates a new pro subscription for the user, and the
**user needs to be logged in**.
It returns the Stripe checkout URL.

## Request body

- UserSubscription
  - `id` integer
  - `tier` 'F' | 'P' | 'T'
  - `status` 'A' | 'O' | 'P' | 'C'
  - `current_period_start` string, date-time
  - `current_period_end` string, date-time

## Response `201`

Created

---

[API](https://skmtc.dev/cannoli/apis/cannoli-backend-api.md) - [All operations](https://skmtc.dev/cannoli/apis/cannoli-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cannoli/apis/cannoli-backend-api/revisions/d27aef14fd7a?raw)