---
title: "Create Customer Portal Session"
method: POST
path: "/iap/customer-portal-sessions"
tags: ["Subscriptions"]
---

# Create Customer Portal Session

`POST /iap/customer-portal-sessions`

Creates a Stripe Customer Portal session URL. The portal lets users manage their subscriptions, update payment methods, and view billing history.

## Request body

- object
  - `user_id` string, required — The user's external ID.
  - `return_url` string — URL to redirect the user to after they leave the portal.

## Response `200`

Portal session created

- object
  - `portal_url` string — URL to redirect the user to the Stripe Customer Portal.

## Other responses

- `400` — Invalid request -- missing or malformed parameters.
- `401` — Invalid or missing API key.
- `404` — Resource not found.

---

[API](https://skmtc.net/zerosettle/apis/zerosettle-iap-api.md) · [All operations](https://skmtc.net/zerosettle/apis/zerosettle-iap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerosettle/zerosettle-iap-api/versions/1a7aa12f3d5e/schema)