---
title: "Create a billing portal session in the unified subscription system"
method: POST
path: "/organizations/{organization_id}/subscription/billing_portal"
tags: ["organizations/subscription/billing"]
---

# Create a billing portal session in the unified subscription system

`POST /organizations/{organization_id}/subscription/billing_portal`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/organizations/{organization_id}/subscription/billing_portal`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/organizations/:organization_id/subscription/billing_portal/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a subscription billing portal session in the unified subscription system

## Path parameters

- `organization_id` integer, required

## Request body

- BillingportalPayload
  - `country_code` string
  - `return_url` string

## Response `200`

Billing portal session created

## Other responses

- `400`: Invalid billing portal session data
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)