Skip to main content
POST
Requires X-Api-Key and X-Api-Secret headers. See Authentication for details.
The user is created with status: "pending". They cannot perform financial operations until KYC is approved and their status transitions to active. After creating the user, call Start KYC to begin identity verification.

Authorizations

X-Api-Key
string
header
required

Partner API key. Generated from Qash Dashboard → Settings → API Keys.

X-Api-Secret
string
header
required

Partner API secret. Shown once at creation — store it securely.

Body

application/json

User registration payload.

email
string<email>
required

User email address. Must be unique across all of Qash.

Example:

"user@example.com"

countryCode
string
required

ISO 3166-1 alpha-2 country code.

Required string length: 2
Example:

"CO"

phone
string

Phone number in international format. Automatically trimmed.

Example:

"+573001234567"

preferredLanguage
string

Preferred language code. Defaults to en.

Example:

"es"

Response

User created successfully.

success
boolean
required
Example:

true

data
object
required
message
string
Example:

"User created successfully"