Skip to main content
POST
Create account

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Body

application/json
name
string
required
Required string length: 1 - 100
slug
string

Unique account slug. Omit to derive it deterministically from the name. A duplicate slug is rejected as already existing; creation does not replay the existing account. Filter the account list by slug to find it.

Maximum string length: 63
Pattern: ^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$

Response

Account created; the caller is its owner

id
string<uuid>
required
slug
string
required
name
string
required
kind
enum<string>
required

Created account kind; always team.

Available options:
personal,
team
created_at
string
required
updated_at
string
required
membership
object
required

The caller's own membership in this account, including their resolved role and capabilities.