KintsugiKintsugi
API reference / Create a chargebee self-serve customer portal session

Create a chargebee self-serve customer portal session

POST/billing/portal-session

Creates a Chargebee self-serve customer portal session (URL, token, and the fields Chargebee.js needs) for the org selected by Organization-Id, Connection-Id, or Entity-Id. Creates the Chargebee customer record on first use, billed to the authenticated identity's name and email.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Response

idstringRequired

Chargebee portal session id.

tokenstringRequired

Portal session token. Treat as a secret.

accessUrlstringRequired

One-time portal URL. Treat as a secret.

statusstringRequired

Portal session status, e.g. created.

createdAtstringRequired

When the session was created.

expiresAtstringRequired

When the portal URL expires.

objectstringRequired

Chargebee object type, portal_session.

customerIdstringRequired

Chargebee customer id the session is for.

redirectUrlstring

Where the portal sends the user on exit, or null.

linkedCustomersPortalLinkedCustomer[]Required

Other Chargebee customers reachable from this session.

201

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

404

The requested resource was not found.

422

Validation Error

cURL
POST /billing/portal-session
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Response
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"token": "tok_2mNpQr7Ls8f3k",
"accessUrl": "https://www.example.com",
"status": "ACTIVE",
"createdAt": "2026-07-28T12:00:00Z",
"expiresAt": "2026-07-28T12:00:00Z",
"object": "object",
"customerId": "cust_2mNpQr7Ls8f3k",
"redirectUrl": "https://www.example.com",
"linkedCustomers": [
{
"customerId": "cust_2mNpQr7Ls8f3k",
"email": "jane.doe@example.com",
"hasActiveSubscription": false,
"hasBillingAddress": false,
"hasPaymentMethod": false,
"object": "object"
}
]
}
Create a chargebee self-serve customer portal session (2026-07-21) | Kintsugi API Reference