# Create a billing self-serve customer portal session

> POST /billing/portal-session

Source: https://docs.trykintsugi.com/reference/2026-10-06/create-a-billing-self-serve-customer-portal-session

API version: Tenanted API release 2026-10-06, latest, default in the docs

POST /billing/portal-session

Create a billing self-serve customer portal session

Creates a billing self-serve customer portal session (URL, token, and the fields the embedded self-serve portal widget needs) for the org selected by Organization-Id, Connection-Id, or Entity-Id. Creates the billing customer record on first use, billed to the authenticated identity's name and email. Requires an owner or admin of the organization, or the organization's own API key.

Category: Billing

Response fields:
id (string, required) - Billing portal session id.
token (string, required) - Portal session token. Treat as a secret.
accessUrl (string, required) - One-time portal URL. Treat as a secret.
status (string, required) - Portal session status, e.g. `created`.
createdAt (string, required) - When the session was created.
expiresAt (string, required) - When the portal URL expires.
object (string, required) - Billing object type, `portal_session`.
customerId (string, required) - Billing customer id the session is for.
redirectUrl (string) - Where the portal sends the user on exit, or null.
linkedCustomers (PortalLinkedCustomer[], required) - Other billing customers reachable from this session.
  customerId (string, required) - Billing customer id.
  email (string, required) - Email of the linked customer.
  hasActiveSubscription (boolean, required) - Whether the linked customer has an active subscription.
  hasBillingAddress (boolean, required) - Whether the linked customer has a billing address on file.
  hasPaymentMethod (boolean, required) - Whether the linked customer has a payment method on file.
  object (string, required) - Billing object type, `linked_customer`.

Response statuses: 201, 400, 401, 403, 404, 422

---

Index of every page: https://docs.trykintsugi.com/llms.txt