---
title: "Create Portal Session"
method: POST
path: "/billing/portal"
tags: ["billing"]
---

# Create Portal Session

`POST /billing/portal`

## Query parameters

- `return_to` string, nullable

## Response `200`

Successful Response

- PortalResponse
  - `url` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-04** `eb694aedc555` — 2 info
  - added the new optional `query` request parameter `return_to`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/stardrift/apis/fastapi/changes/billing/portal/post.md)

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/stardrift/apis/fastapi/revisions/f6559d3df7e9?raw)