Skip to main content
POST
/
2023-11
/
admin
/
users
Add User
curl --request POST \
  --url https://api-staging.genuka.com/2023-11/admin/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
"{\n  \"first_name\": \"\",\n  \"last_name\": \"Test\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"\",\n  \"role\": \"employee\", // manager, admin\n  \"shop_ids\": [ // id for shops\n    \"01k1amypzhgs7fngfx1r9d37pn\"\n  ],\n  \"permissions\": [\n    \"collections.*\",\n    \"orders.view\",\n    \"orders.create\",\n    \"products.view\",\n    \"products.create\",\n    \"products.update\",\n    \"products.delete\",\n    \"customers.view\",\n    \"customers.create\",\n    \"customers.update\",\n    \"suppliers.view\",\n    \"warehouses.*\",\n    \"suppliers.create\",\n    \"suppliers.update\",\n    \"expenses.view\",\n    \"expenses.create\",\n    \"returns.view\",\n    \"returns.create\",\n    \"returns.update\"\n  ],\n  \"password\": \"PassWord!123\"\n}"
'
{
  "allPermissions": [
    "returns.view",
    "returns.create",
    "returns.update",
    "orders.view",
    "orders.create",
    "products.view",
    "products.create",
    "products.update",
    "products.delete",
    "customers.view",
    "customers.create",
    "customers.update",
    "collections.*",
    "warehouses.*",
    "suppliers.view",
    "suppliers.create",
    "suppliers.update",
    "expenses.view",
    "expenses.create"
  ],
  "birthdate": null,
  "company_id": "01hqydxwtxdj3kmzp3bz7jk73g",
  "created_at": "2025-10-13T09:25:31.000000Z",
  "deleted_at": null,
  "email": "[email protected]",
  "first_name": null,
  "id": "01k7ee7anat9j4bn5v71v70qck",
  "last_activity": null,
  "last_login_at": null,
  "last_login_ip": null,
  "last_name": "Test",
  "medias": [],
  "metadata": null,
  "name": " Test",
  "opt_in": 0,
  "permissions": [
    "returns.view",
    "returns.create",
    "returns.update",
    "orders.view",
    "orders.create",
    "products.view",
    "products.create",
    "products.update",
    "products.delete",
    "customers.view",
    "customers.create",
    "customers.update",
    "collections.*",
    "warehouses.*",
    "suppliers.view",
    "suppliers.create",
    "suppliers.update",
    "expenses.view",
    "expenses.create"
  ],
  "phone": "",
  "pin_enabled": false,
  "role": "employee",
  "shops": [
    {
      "company_id": "01hqydxwtxdj3kmzp3bz7jk73g",
      "created_at": "2025-07-29T09:32:01.000000Z",
      "currency_code": "XAF",
      "currency_name": "FCFA",
      "deleted_at": null,
      "description": "Debitis non rerum aperiam tenetur placeat ut dignissimos.",
      "id": "01k1amypzhgs7fngfx1r9d37pn",
      "metadata": null,
      "name": "Brekke Group",
      "pivot": {
        "shop_id": "01k1amypzhgs7fngfx1r9d37pn",
        "user_id": "01k7ee7anat9j4bn5v71v70qck"
      },
      "slug": "brekke-group",
      "updated_at": "2025-07-29T09:32:01.000000Z"
    }
  ],
  "updated_at": "2025-10-13T09:25:31.000000Z"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-company
string
Example:

"{{companyId}}"

Response

200 - application/json

200

allPermissions
string[]
Example:
[
"returns.view",
"returns.create",
"returns.update",
"orders.view",
"orders.create",
"products.view",
"products.create",
"products.update",
"products.delete",
"customers.view",
"customers.create",
"customers.update",
"collections.*",
"warehouses.*",
"suppliers.view",
"suppliers.create",
"suppliers.update",
"expenses.view",
"expenses.create"
]
birthdate
unknown
company_id
string
Example:

"01hqydxwtxdj3kmzp3bz7jk73g"

created_at
string
Example:

"2025-10-13T09:25:31.000000Z"

deleted_at
unknown
email
string
first_name
unknown
id
string
Example:

"01k7ee7anat9j4bn5v71v70qck"

last_activity
unknown
last_login_at
unknown
last_login_ip
unknown
last_name
string
Example:

"Test"

medias
any[]
Example:
[]
metadata
unknown
name
string
Example:

" Test"

opt_in
number
Example:

0

permissions
string[]
Example:
[
"returns.view",
"returns.create",
"returns.update",
"orders.view",
"orders.create",
"products.view",
"products.create",
"products.update",
"products.delete",
"customers.view",
"customers.create",
"customers.update",
"collections.*",
"warehouses.*",
"suppliers.view",
"suppliers.create",
"suppliers.update",
"expenses.view",
"expenses.create"
]
phone
string
Example:

""

pin_enabled
boolean
Example:

false

role
string
Example:

"employee"

shops
object[]
Example:
[
{
"company_id": "01hqydxwtxdj3kmzp3bz7jk73g",
"created_at": "2025-07-29T09:32:01.000000Z",
"currency_code": "XAF",
"currency_name": "FCFA",
"deleted_at": null,
"description": "Debitis non rerum aperiam tenetur placeat ut dignissimos.",
"id": "01k1amypzhgs7fngfx1r9d37pn",
"metadata": null,
"name": "Brekke Group",
"pivot": {
"shop_id": "01k1amypzhgs7fngfx1r9d37pn",
"user_id": "01k7ee7anat9j4bn5v71v70qck"
},
"slug": "brekke-group",
"updated_at": "2025-07-29T09:32:01.000000Z"
}
]
updated_at
string
Example:

"2025-10-13T09:25:31.000000Z"