Skip to main content
POST
Register a new user

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
username
string
required

Username: 3 to 32 letters, digits, ., _ or -, with single spaces between words

Required string length: 3 - 32
Example:

"user"

password
string
required

Password: at least 15 characters and at most 72 bytes in UTF-8

Minimum string length: 15
Example:

"StrongPassword123!"

email
string
required

Email address. Stored trimmed and lowercased; disposable domains are refused.

Maximum string length: 254
Example:

"user@example.com"

acceptTerms
boolean
required

Must be true: the new account accepts the terms at https://app.soroswap.finance/terms

Example:

true

accountType
enum<string> | null
Available options:
COMPANY,
INDIVIDUAL
Example:

"COMPANY"

companyName
string | null
Maximum string length: 120
Example:

"Acme"

As on invoices

Maximum string length: 160
Example:

"Acme S.A."

country
string | null

ISO 3166-1 alpha-2 code, stored uppercase

Example:

"CL"

website
string | null

An http or https URL, scheme included

Maximum string length: 255
Example:

"https://acme.com"

segment
enum<string> | null
Available options:
WALLET,
EXCHANGE,
FINTECH,
PAYMENTS,
DEFI,
TRADING_BOT,
AI_AGENT,
OTHER
Example:

"WALLET"

telegram
string | null

Telegram username, with or without the leading @ (stored without it): 5 to 32 letters, digits or _, starting with a letter

Example:

"acme_ops"

turnstileToken
string

Cloudflare Turnstile token. Required when GET /auth/config has a site key.

Response

User registered successfully

message
string
Example:

"User test@example.com registered"