---
title: "Create Stripe Customer Portal Session"
method: POST
path: "/api/v1/billing/portal"
tags: ["Billing"]
---

# Create Stripe Customer Portal Session

`POST /api/v1/billing/portal`

## Request

- Base URL: `https://api.bellatorsi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bellatorsi.com/api/v1/billing/portal`
- Auth: none declared

Creates a Stripe Customer Portal session for the authenticated user. Redirect the user to `portal_url` to manage their subscription, update payment methods, or download invoices. Requires an active Stripe customer (i.e., user must have checked out at least once).

## Headers

- `Authorization` string, nullable

## Response `200`

Successful Response

- PortalSessionResponse: Stripe Customer Portal session response. Attributes: portal_url: Stripe-hosted portal URL; redirect user here.
  - `portal_url` string, required: Stripe Customer Portal URL — redirect user here

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis.md) · [All operations](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/revisions/03e7b786e43b?raw)