---
title: "Create a portal session to change subscription plan"
method: POST
path: "/v1/billing/subscription/change"
tags: ["Billing"]
---

# Create a portal session to change subscription plan

`POST /v1/billing/subscription/change`

## Request body

- ChangeSubscriptionDto
  - `productId` string, uuid, required — Target product ID to switch to
  - `returnUrl` string, uri, required — URL to redirect to after the portal session

## Response `201`

Subscription change session created successfully

- PortalSessionApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object, required — Response data
    - `portalUrl` string, uri, required — Stripe portal session URL
  - `timestamp` string, date-time, required — Timestamp of the response

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maket/virtual-architect-api/revisions/b712097baa9c/schema)