---
title: "Start paying for a plan"
description: "Admins only."
canonical: "https://gtable.app/docs/builder-api/billing/checkout"
updated: "2026-10-05"
---

# Start paying for a plan

`POST https://studio.gtable.app/v1/organizations/{organizationId}/billing/checkout`

Admins only.

For an organisation with no paid subscription: returns a Stripe Checkout address where a person enters a card, after which the plan applies. Nothing is charged until they complete it there. An organisation that already pays changes plan with billing.change instead. Refused with 501 while billing is not connected.

Requires the `account:write` scope. Operation `billing.checkout`. MCP tool `billing_checkout`. CLI, once published: `gtable billing checkout`.

## Path parameters

| Name             | Type   | Required | Description |
| ---------------- | ------ | -------- | ----------- |
| `organizationId` | string | yes      |             |

## Headers

| Name              | Type   | Required | Description                                                                                                                                                                                                                                                        |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Idempotency-Key` | string | no       | Any unique string. Sending the same key with the same request again returns the first response (marked `Idempotency-Replayed: true`) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters. |

## Request body

| Field      | Type                                      | Required | Description          |
| ---------- | ----------------------------------------- | -------- | -------------------- |
| `plan`     | "free" or "starter" or "team" or "custom" | yes      |                      |
| `interval` | "monthly" or "yearly"                     | no       | Default `"monthly"`. |