Create User

Create a user in an organization

post

Root user adds a new user by providing their Ed25519 public key.

Authorizations

X-StampstringRequired

Base64URL-encoded JSON: { "publicKey": "<hex ed25519 pubkey>", "signature": "<hex ed25519 sig>" }. The signature covers JSON.stringify([binding, Object.entries(params)]), where binding is "<METHOD> <routePath>" (the server's route pattern, e.g. "POST /waas/create-wallet") and params is the request body (POST) or query params (GET). This binds the stamp to its own route so it cannot be replayed against a different endpoint. The one parameterized route, GET /waas/scheduled-transaction/{scheduleId}, binds to the literal "GET /waas/scheduled-transaction/:scheduleId", not the concrete ID. See the Signing Requests guide for runnable examples.

Body

organizationIdstringRequired

publicKeystringRequired

Hex-encoded Ed25519 public key of the new user

noncestringRequired

Responses

200

User created

application/json

400

Bad request

application/json

401

Invalid or missing X-Stamp

application/json

403

Insufficient permissions

application/json

500

Internal server error

application/json

post/waas/create-user

POST /waas/create-user HTTP/1.1
Host: api.hinkal.io
X-Stamp: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "organizationId": "text",
  "publicKey": "text",
  "nonce": "text"
}

{
  "status": "success",
  "data": {
    "userId": "text",
    "role": "text",
    "addresses": [
      {
        "evm": "0xabc123...",
        "tron": "TXyz...",
        "solana": "Fg6PaFpo..."
      }
    ]
  }
}