Add user

POST /users

Overview

Stores a new user’s information in the database.

This operation is commonly performed immediately after user creation or authentication, allowing the system to accurately track and manage users.

Typical use cases

• Saving a newly registered user

• Ensuring user consistency across services

Header

Name	Value
Content-Type	application/json
Authorization (API Key)	Bearer <API Key>

Body

Name	Type	Description
email	string	Email of the user
userId (optinal)	string	User identifier (user_id). Optional on create — if not provided, a system-generated ID will be used More description
name (optinal)	string	Name of the user
metadata (optinal)	object	A set of custom key-value pairs to be stored in the user’s profile. More description

Response

200

{
    "message": "resource created successfully",
    "user_id": "testUserId",
    "klaim_id": "1753306133860_A36dL",
    "email": "[e-mail]",
    "credit_balance": 0,
    "created_at": 1753306133860,
    "name": "Test API",
    "metadata": {
        "test": "field"
    }
}

400

409