Skip to main content
POST
Create an account

Body

application/json
email
string
required
Example:

"alex@example.com"

password
string
required
Example:

"correct horse battery staple"

captcha_response
string
Example:

"0.AbCdEf…"

data
string

Free-form signup metadata, as a JSON string.

Example:

"{\"campaign\":\"launch\"}"

refid
string

The referrer's code, if the signup came through a referral link.

Example:

"CAL7X2QM"

Response

201 - application/json
base_currency_id
string
required
Example:

"usdc"

can_change_password
boolean
required

Whether the old→new password change flow applies. False for wallet-native and social accounts, which carry a random password the holder never set.

Example:

true

Whether no wallet is linked yet, so the connect flow should be offered.

Example:

false

created_at
string
required
Example:

"2026-07-01T09:12:00Z"

email
string
required
Example:

"alex@example.com"

entity_type
enum<string>
required
Available options:
individual,
business
Example:

"individual"

level
number
required

Verification level, 0–3. Trading gates are expressed against this.

Example:

2

otp
boolean
required

Whether 2FA is enabled. A boolean, not the secret.

Example:

true

role
string
required
Example:

"member"

state
enum<string>
required
Available options:
pending,
active,
banned,
deleted
Example:

"active"

uid
string
required

The public account identifier.

Example:

"ID1A2B3C4D5E"

updated_at
string
required
Example:

"2026-07-02T14:30:00Z"

user_id
number
required
Example:

4821

advisor_id
number | null
Example:

null

advisory_id
number | null
Example:

null

aggregator_merchant_user_id
string | null
Example:

null

data
object

Free-form account data.

Example:
member_id
number | null

The trading identity in atlas. Null until one is provisioned.

Example:

4821

parent_user_id
number | null
Example:

null

referral_code
string | null
Example:

"CAL7X2QM"

Example:

"https://calibri.io/?ref=CAL7X2QM"

wallet_address
string | null

The linked EOA, if any. Null for accounts that have not linked a wallet.

Example:

"0xE1188438C85C98aADFf1a88f97764E607B4978C3"