---
title: "Create billing portal session"
method: POST
path: "/api/cloud/billing/portal"
tags: ["Cloud"]
---

# Create billing portal session

`POST /api/cloud/billing/portal`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/cloud/billing/portal`
- Auth: API key in cookie `hk_token`

Creates a Stripe Customer Portal session for the authenticated hosted Cloud team. Requires team.manage_settings on the active team.

## Request body

- object
  - `locale` string

## Response `200`

Billing portal session

- object
  - `url` string, required

## Other responses

- `401`: Unauthorized
- `404`: Cloud billing account not found
- `409`: Stripe customer is not configured
- `502`: Unable to start billing portal

---

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