> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chowder.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Checkout Session

> Generate a Stripe Checkout URL to upgrade your subscription.

Start a subscription upgrade by generating a Stripe Checkout session. You'll get back a URL — redirect your user there to complete payment. Once they do, a webhook fires on our end and your organization's tier is updated automatically. No polling required.

## Authorization

Requires an **organization-level** API key in the `Authorization` header.

## Request Body

<ParamField body="tier" type="string" required>
  The tier to upgrade to. Must be one of `crab` or `lobster`. If you need whale-tier access, [reach out to us directly](https://chowder.dev/contact).
</ParamField>

## Response

<ResponseField name="url" type="string">
  A Stripe Checkout URL. Redirect the user here to complete payment.
</ResponseField>

<RequestExample>
  ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  curl -X POST https://api.chowder.dev/v1/subscription/checkout \
    -H "Authorization: Bearer chd_sk_your_org_key" \
    -H "Content-Type: application/json" \
    -d '{
      "tier": "lobster"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  {
    "url": "https://checkout.stripe.com/c/pay/cs_live_a1b2c3..."
  }
  ```
</ResponseExample>