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

# New User Trial Subscription

`POST /subscriptions/create_user_trial_subscription/`

## Request

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

This endpoint creates a new free subscription for the user with a 
trial of 30 days, and the **user needs to be logged in**.

## 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

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

---

[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)