Sign in
Businesses

Create a 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.

post/api/business

Request body

namestring required

What the business is called.

usernamestring

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.

websiteUrlstring uri

An existing website for the business. Must be https and must be publicly fetchable.

descriptionstring

What the business does, in the account's own words. The input to every later suggestion.

kindstring

The signup interview's first answer: what kind of thing this is.

Response

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

Changes