Skip to main content
POST
/
api
/
v1
/
partner
/
users
curl --request POST \
  --url https://api.qash.ai/api/v1/partner/users \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --data '
{
  "userType": "personal",
  "email": "user@example.com",
  "countryCode": "CO"
}
'
{
  "success": true,
  "data": {
    "user": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "user@example.com",
      "status": "pending",
      "createdAt": "2026-05-27T10:00:00.000Z"
    }
  },
  "message": "User created successfully"
}
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.

​
userType
enum<string>
required

Type of user account.

Available options:
personal,
business
​
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"