Skip to main content
A customer portal session gives a customer a short-lived authenticated URL to manage their own subscriptions — cancel, view billing history, and update payment methods.

The portal session object

string
The URL to redirect the customer to. Valid until expires_at.
string
The session token embedded in the URL.
string
ISO 8601 timestamp. The session expires shortly after creation.

Create a portal session

POST /customers/{customer_id}/portal Create a session and redirect the customer to the returned url. The URL is single-use and short-lived — generate it on demand, never store it.
No request body required.