× Docs Platform Dashboard Extensions Applications Building Merchants Sign in


When a company is registered it not only creates a company but also a user. This user is a special “owner” user that cannot be deleted and is also automatically designated as part of the admin permission group.

Outside of the “owner” users, Rehive supports the creation/registration of users under specific groups (roles) and permissions. Users have several optional unique identifiers:

  • id
  • username
  • email
  • mobile

These identifier may not be shared by any other users in the company*.


Users have a multitude of attributes and properties that can be used to store identity information as well as settings and state. The full user object looks like this:

    "id": "00000000-0000-0000-0000-000000000000",
    "first_name": "Joe",
    "last_name": "Soap",
    "email": "[email protected]",
    "username": null,
    "id_number": "",
    "birth_date": "2000-01-01",
    "profile": null,
    "company": "rehive",
    "currency": {
        "description": "Rand",
        "code": "ZAR",
        "symbol": "R",
        "unit": "rand",
        "divisibility": 2
    "account": "0000000000",
    "balance": 0,
    "available_balance": 0,
    "language": "en",
    "nationality": "ZA",
    "website": null,
    "metadata": null,
    "mobile": "+27840000000",
    "timezone": "Asia/Dhaka",
    "verified": true,
    "verification": {
        "email": true,
        "mobile": true
    "status": "pending",
    "groups": [
            "name": "user",
            "label": "User"
    "created": 1464912953000,
    "updated": 1464912953000,
    "settings": {
        "allow_transactions": true,
        "allow_debit_transactions": true,
        "allow_credit_transactions": true,
        "disallowed_transaction_subtypes": []
    "deactivated": false,
    "last_login": 1464912953000,
    "archived": false,
    "temporary": false


User data can be accessed via several endpoints within the auth, admin and user sections.

Take a look at the API Reference for the list of user endpoints.

All endpoints that contain /user/ or /users/ in their URL path are used for handling users and resources belonging to them.


Usage remains the same for all endpoints in Rehive. Simply invoke one of the allowed HTTP methods with the correct Content-Type and an Authorization header.