---
title: "Create or update subscription"
method: POST
path: "/teams/{teamId}/billing/subscribe"
tags: ["Billing"]
---

# Create or update subscription

`POST /teams/{teamId}/billing/subscribe`

## Request

- Base URL: `https://api.katla.app`
- URL: `https://api.katla.app/teams/{teamId}/billing/subscribe`
- Auth: HTTP bearer

## Path parameters

- `teamId` string, uuid, required

## Request body

- object
  - `planId` string, uuid, required
  - `billingInterval` 'monthly' | 'annual', required
  - `successUrl` string, uri
  - `cancelUrl` string, uri
  - `voucher` string

## Response `200`

Default Response

- object
  - `checkoutUrl` string, nullable, required

## Other responses

- `400`: Default Response
- `404`: Default Response
- `409`: Default Response

---

[API](https://skmtc.dev/katla/apis/katla-api.md) · [All operations](https://skmtc.dev/katla/apis/katla-api/llms.txt) · [OpenAPI document](https://skmtc.dev/katla/apis/katla-api/revisions/6ed2d7f0b009?raw)