---
title: "Open a Stripe billing portal session for the caller."
method: POST
path: "/v1/billing/portal"
tags: ["Billing"]
---

# Open a Stripe billing portal session for the caller.

`POST /v1/billing/portal`

## Request

- Base URL: `https://api.inboxy.net`
- URL: `https://api.inboxy.net/v1/billing/portal`
- Auth: HTTP bearer

Requires `manage` scope. No request body. Refuses if the account has never checked out (`no_subscription`, 409 — no `stripe_customer_id` on file yet).

## Response `200`

Portal session created — redirect the caller to `url`.

- object
  - `url` string, uri, required

## Other responses

- `403`: Token lacks the required scope.
- `409`: `no_subscription` — no billing account yet; checkout first.

---

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