---
title: "Open the Stripe customer portal (payment methods, invoices, receipts, cancel or switch tier); creates the Stripe customer on first use (30 per account per hour)"
method: POST
path: "/v1/account/billing/portal-sessions"
---

# Open the Stripe customer portal (payment methods, invoices, receipts, cancel or switch tier); creates the Stripe customer on first use (30 per account per hour)

`POST /v1/account/billing/portal-sessions`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/account/billing/portal-sessions`
- Auth: API key in cookie `rove_session`

## Response `201`

Successful response (Cache-Control: no-store)

- object
  - `url` string, required: A one-time Stripe customer portal link; it returns to the billing page.

## Other responses

- `401`: RFC 7807 owner-session-required: sign in at owner_action_url
- `403`: RFC 7807 owner-origin-refused (mutations only)
- `429`: RFC 7807 purchase-rate-limited; Retry-After
- `503`: RFC 7807 billing-unavailable; Retry-After: 30, retry same_key

---

[API](https://skmtc.dev/roveapi/apis/rove-api.md) · [All operations](https://skmtc.dev/roveapi/apis/rove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roveapi/apis/rove-api/revisions/0e5d69bde586?raw)