---
title: "Create Enterprise Checkout Link"
method: POST
path: "/admin/create-checkout-link"
tags: ["Admin"]
---

# Create Enterprise Checkout Link

`POST /admin/create-checkout-link`

## Request

- Base URL: `https://api.oxlo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oxlo.ai/admin/create-checkout-link`
- Auth: HTTP bearer

Create a Stripe Checkout link for enterprise/custom billing.

This generates a shareable checkout URL where:
- The customer email is pre-filled and locked
- X days of free trial are shown
- $Y/month is shown as the recurring price after trial
- The customer enters their card and subscribes

When the customer completes checkout:
- The existing handle_checkout_completed webhook fires
- The plan is activated automatically in the DB
- If a Stripe trial was set, they won't be charged until trial ends

Optionally, grant_trial_access=true (default) also gives DB-level
plan access immediately so the user can start using the service
before completing payment.

Flow for the admin:
1. Create checkout link via this endpoint
2. Send the URL to the customer (email, Slack, etc.)
3. Customer clicks link, sees trial + price, enters card
4. Plan activates automatically

## Request body

- CreateCheckoutLinkRequest
  - `email` string, email, required
  - `plan_id` string, required
  - `amount_cents` integer, required
  - `trial_days` integer
  - `plan_display_name` string, nullable
  - `grant_trial_access` boolean

## Response `200`

Successful Response

- CreateCheckoutLinkResponse
  - `checkout_url` string, required
  - `email` string, required
  - `plan_id` string, required
  - `amount_display` string, required
  - `trial_days` integer, required
  - `message` string, required
  - `trial_granted` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxlo/apis/oxlo-backend.md) - [All operations](https://skmtc.dev/oxlo/apis/oxlo-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/oxlo/apis/oxlo-backend/revisions/bc2ecdc94f31?raw)