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

# Create Customer Portal Session

`POST /v1/customer-portal`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/customer-portal`
- Auth: API key in header `Authorization`

Open the billing portal to manage your organization's subscription.

Returns a hosted Polar portal URL where you can cancel, change your payment
method, or view invoices. Requires an active or past subscription.

## Headers

- `X-Organization-Id` string, uuid, nullable

## Request body

- CustomerPortalRequest: Request body for ``POST /v1/customer-portal``.
  - `return_url` string, uri, nullable

## Response `200`

Successful Response

- CustomerPortalResponse
  - `redirect_url` string, uri, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fettle/apis/fettle-sh.md) · [All operations](https://skmtc.dev/fettle/apis/fettle-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/fettle/apis/fettle-sh/revisions/f32c8a18606f?raw)