---
title: "Create customer portal session"
method: POST
path: "/v1/subscription/portal"
tags: ["Subscription"]
---

# Create customer portal session

`POST /v1/subscription/portal`

## Request

- Base URL: `https://api.astrocal.dev`
- URL: `https://api.astrocal.dev/v1/subscription/portal`
- Auth: HTTP bearer

Creates a Stripe Customer Portal Session for managing the existing subscription. The portal handles payment method updates, plan changes, cancellations, and invoice history.

## Response `200`

Portal session created

- object
  - `portal_url` string, required

## Other responses

- `401`: Unauthorized
- `404`: No Stripe Customer exists

---

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