Admins

Manage admin accounts and access for your loyalty program.

Admins are users who can access the Admin Panel for your tenant. Add one admin per person. Use roles to control what they can see and edit.

When your tenant is first set up, you get initial credentials with full permissions. Create additional admins for teammates or service providers.

To restrict access, create a role first, then assign it to the admin. See Roles.

Admins assigned to a restricted role can only access resources granted by that role.

The Admins list includes active and inactive users (inactive rows are grayed out). You can also see:

• Name and surname

• Email

• Authentication method

• Active status

• Whether notifications are enabled

---

📋 Open the Admins list

1. Go to Settings → Admins.

2. Review the table. Use the Active column to confirm status.

3. (Optional) Change rows per page using the selector under the table.

---

➕ Add an admin

1

Open the create screen

1. Go to Settings → Admins.

2. Click + ADD ADMIN.

2

Fill in basic details

Complete the required fields:

• Name (optional)

• Last name (optional)

• Role

• Phone number (optional, if configured)

• Email (must be unique)

• Password and Repeat password (for Admin Panel login)

Generate a random password for the new admin. Instruct them to use the Forgot password feature to access their account without sharing the password.

3

Set status and save

1. Set Active to enabled (toggle turns purple).

2. (Optional) Enable Notifications.

3. Click ADD ADMIN.

---

🔑 Admin password (set or reset)

Admins use a password to log in to the Admin Panel.

If an admin forgets their password, they can reset it using the password recovery flow.

A recovery link is sent to the email address tied to the account.

---

🔐 Permanent user token (API key)

A permanent user token (“API key”) lets an admin authenticate API calls.

The API key does not replace the password. Use it for API authentication only.

1

Generate a key

1. Create the admin (if needed).

2. Open the admin details.

3. In Permanent user token, click Generate new key.

4. Set a key name and expiry date (recommended).

5. Copy the API key and store it safely.

You can’t view the key again after closing the window. Generate a new one if needed.

For technical details, see API Key authentication.

Use the token in requests

You can pass the token using headers (recommended) or a query parameter.

Example (header):

curl http://localhost:8181/api/admin \
    -X "GET" -H "Accept: application/json" \
    -H "Content-type: application/json" \
    -H "X-AUTH-TOKEN: customPermanentToken"

---

✏️ Manage admins

In Settings → Admins, open the ⋮ menu on a row:

• Edit to update details, then click SAVE SETTINGS.

• Enable/Disable notifications to toggle notifications for that admin.

To exit Add Admin or Edit Admin, click X in the header.