---
title: "Create a business"
method: POST
path: "/api/business"
tags: ["Businesses"]
---

# Create a business

`POST /api/business`

Creates the business and claims its permanent public @handle. It SPENDS NOTHING: describing a business comes before paying for one, so an account with no plan may call this, and the paid setup — the content workspace, the app backend, the subdomains — is released later by the payment projection. An account that already pays gets that release before the response. Answers 201 for a new row and 200 when a double-submit resolved to a row that already existed.

## Request body

- NewBusiness
  - `name` string, required — What the business is called.
  - `username` string — The public @handle, without the leading @. PERMANENT: it names the public pages and the tenant subdomains, and there is no rename. Omit it and one is derived from the name.
  - `websiteUrl` string, uri — An existing website for the business. Must be https and must be publicly fetchable.
  - `description` string — What the business does, in the account's own words. The input to every later suggestion.
  - `kind` string — The signup interview's first answer: what kind of thing this is.

## Response `200`

A double-submit resolved to the business the first request created.

- object
  - `data` Business, required
    - `id` string, required — The business's id.
    - `username` string, nullable, required — Its permanent public @handle, without the leading @.

## Other responses

- `201` — The business that was created.
- `400` — The request body did not match the schema for this operation.
- `401` — No session token, or a token that is expired or invalid.
- `409` — The write lost a race for a unique value, such as an @handle.
- `422` — A field parsed but is not usable — an invalid @handle, or a website URL that does not resolve.
- `500` — Something failed on our side. The response body says so and nothing more; the detail is in our logs.

---

[API](https://skmtc.dev/result/apis/result-api.md) · [All operations](https://skmtc.dev/result/apis/result-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/result/result-api/revisions/103d45168871/schema)