Skip to main content
POST
/
v2
/
users
Create User
curl --request POST \
  --url https://api.stablepay.global/v2/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "externalId": "<string>",
  "deviceId": "<string>"
}
'
{
  "success": true,
  "data": {
    "userId": "usr_abc123def456",
    "depositAddresses": {
      "evm": "0x742d35Cc6634C0532925a3b844Bc9e7595f3A123",
      "tron": "TN7FbQz9Mwi4pPYkXRmpVMaccut3Fk8BBB"
    },
    "kycStatus": "pending"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.stablepay.global/llms.txt

Use this file to discover all available pages before exploring further.

Create User

Creates a new user. Deposit addresses are only generated for accounts with transactionMode: sell or transactionMode: both.
name
string
required
Full name of the user
mobile
string
required
Mobile number with country code (e.g., +919876543210)
email
string
Email address
externalId
string
Your internal user ID for reference
deviceId
string
Device fingerprint or identifier

Request

curl -X POST https://api.stablepay.global/v2/users \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rahul Kumar",
    "mobile": "+919876543210",
    "email": "rahul@example.com"
  }'

Response

Users created under a sell or both account receive deposit addresses.
{
  "success": true,
  "data": {
    "userId": "usr_abc123def456",
    "depositAddresses": {
      "evm": "0x742d35Cc6634C0532925a3b844Bc9e7595f3A123",
      "tron": "TN7FbQz9Mwi4pPYkXRmpVMaccut3Fk8BBB"
    },
    "kycStatus": "pending"
  }
}
The evm address works across Polygon, Ethereum, Arbitrum, and Base. tron is returned when Tron is enabled on your account.

Next Steps

After creating a user, complete KYC verification so they can transact.

Errors

CodeDescription
USER_EXISTSMobile number already registered for this partner
INVALID_MOBILEInvalid mobile number format
{
  "success": true,
  "data": {
    "userId": "usr_abc123def456",
    "depositAddresses": {
      "evm": "0x742d35Cc6634C0532925a3b844Bc9e7595f3A123",
      "tron": "TN7FbQz9Mwi4pPYkXRmpVMaccut3Fk8BBB"
    },
    "kycStatus": "pending"
  }
}