---
title: "Create a Stripe billing portal session"
method: POST
path: "/v1/billing/portal"
tags: ["Billing"]
---

# Create a Stripe billing portal session

`POST /v1/billing/portal`

## Request

- Base URL: `https://api.usemektup.com`
- URL: `https://api.usemektup.com/v1/billing/portal`
- Auth: HTTP bearer

Returns a URL to Stripe's hosted portal for upgrade/downgrade/payment method/cancel.

## Response `200`

OK

- object
  - `url` string, uri

## Other responses

- `404`: No Stripe customer yet - the account has never checked out
- `503`: Billing not configured yet

---

[API](https://skmtc.dev/usemektup/apis/mektup-api.md) · [All operations](https://skmtc.dev/usemektup/apis/mektup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usemektup/apis/mektup-api/revisions/e394b91cbc53?raw)