Skip to content
Karmo Developer Portal

Create a new account

POST
/customer/account

Request Body

Section titled “Request Body ”
object
name
required
string
memberId
required
string format: uuid
type
string
default: personal
Allowed values: personal business
metadata
object
key
additional properties

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Account created

object
id
required
string format: uuid
tenantId
required
string
name
required
string
type
required
string
Allowed values: personal business
status
required
string
metadata
required
object | null
createdAt
required
string | null
updatedAt
required
string | null

400

Section titled “400 ”

Validation error

object
code
required
string
message
required
string
errors
required
Array<object>
object
field
required
string
message
required
string

401

Section titled “401 ”

Unauthenticated — missing or invalid auth context

object
code
required
string
message
required
string

403

Section titled “403 ”

Forbidden — caller lacks the required permission

object
code
required
string
message
required
string

409

Section titled “409 ”

Account already exists

object
code
required
string
message
required
string

500

Section titled “500 ”

Internal error (e.g. database failure)

object
code
required
string
message
required
string