---
title: "Create checkout session for tier upgrade"
method: POST
path: "/billing/upgrade"
tags: ["billing"]
---

# Create checkout session for tier upgrade

`POST /billing/upgrade`

Create a checkout session for upgrading to a paid tier.

## Request body

- UpgradeRequest
  - `tier` string, required
  - `billing_cycle` string
  - `coupon_code` string, nullable
  - `return_origin` string, nullable — Browser origin (window.location.origin) for Stripe success/cancel URLs

## Response `200`

Checkout session URL for Stripe

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/memara/apis/memara-api.md) · [All operations](https://skmtc.net/memara/apis/memara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memara/memara-api/revisions/4dc7c4418845/schema)