Admin Portal User Guide
The complete written reference for the SmartphoneKey Admin Portal — every section, button and workflow. Use the contents to jump to a topic, or pair it with the interactive walkthrough.
Open the interactive walkthroughAbout this guide
This guide explains how to use the SmartphoneKey Admin Portal from registration onward. It covers the actions available in the portal interface without describing internal system processes.
The sections and buttons visible in your account depend on your role and permissions. You may see only part of the functionality described below.
Register your account and claim your first lock
Use the registration link provided by your administrator or installer.
Step-by-step
- Open the registration page.
- Enter your email address.
- Create a password.
- Enter the lock serial number.
- Enter the Matter code or pairing code supplied with the lock.
- Enter the address if the field is displayed.
- Click Register or Create Account.
- After successful registration, sign in if the portal does not open automatically.
Your account is now linked to your first Entity and lock.
If registration fails
Check the following:
- The serial number is correct.
- The Matter code or pairing code is correct.
- The lock has not already been claimed.
- Your password meets the minimum requirements.
If the issue remains, contact your administrator.
Sign in to the Admin Portal
- Open the SmartphoneKey Portal login page.
- Enter your email address and password.
- Click Sign In.
- After login, open the SPK Portal.
If your session expires while the portal is open, the portal will ask you to sign in again.
Select the current Entity
An Entity is the organization, building, site, or managed area whose devices and users you are working with.
If you have access to more than one Entity:
- Locate the Entity selector in the portal header (top-right, shows the current Entity name and lock count).
- Open the drop-down list.
- Select the required Entity.
- Wait for the page data to refresh.
If you have access to only one Entity, its name is shown in the header but there is no drop-down to switch.
Always confirm the selected Entity before creating users, assigning keys, adding devices, or reviewing logs.
Main navigation
The left-side menu contains a fixed set of top-level sections. Depending on your permissions, you may see all or only some of them:
| Section | Purpose |
|---|---|
| Dashboard | View summary metrics and recent activity. |
| Entities | Create and manage Entities and their Local Admins. |
| Users | Create and manage portal users. |
| Keys | Manage digital keys, physical keys, and Wallet Keys. |
| Devices | Manage locks, hubs, and Matter devices. |
| Cameras | Add and manage cameras and camera roles. |
| Logs | Review activity events and audit history. |
| Settings | Manage your profile, subscription, notifications, access requests, and billing. |
Several sections open with tabs at the top of the page instead of separate menu entries:
- Keys → Keys, Physical Keys, Wallet Keys
- Devices → Locks, Hubs, Matter
- Cameras → Cameras, Camera Roles
- Logs → Activity, Audit
- Settings → Profile, Subscription, Notifications, Access Requests, Billing
Some accounts may not display all sections or tabs.
Dashboard
The Dashboard provides a quick overview of the selected Entity.
Use the Dashboard to:
- Switch between the Locks, Cameras, and Matter views using the tab switcher (shown when more than one view is available).
- Review key metrics such as total locks, active keys, Wallet Keys, physical keys, cameras, hubs, and Matter devices.
- Check recent activity.
- Confirm that you are working in the correct Entity (the Entity name and code are shown on the dashboard).
- Use the quick-action buttons (Give Access, Guest Key, Remove Access) and the Quick access shortcuts when they are available for your role.
When you switch Entities, the Dashboard refreshes automatically.
Manage Entities
Open Entities to create and manage organizations, buildings, sites, or other managed areas. Entities are shown as cards (grid view) or rows (list view); you can filter, search, and sort them.
7.1 Create an Entity
- Open Entities.
- Click Create Entity.
- Enter the Entity name.
- Enter the Entity code.
- Add a description if needed.
- Optionally enter the email address of an initial Local Admin under Add Local Admin.
- Optionally enter the number of Wallet Keys to transfer to that Local Admin.
- Click Create.
Entity code rules
- Use letters, numbers, and underscores only.
- Do not use spaces.
- The code is automatically converted to uppercase.
- Choose the code carefully. It cannot be changed after creation.
7.2 Edit an Entity
- Open Entities.
- Find the required Entity.
- Click the settings (gear) icon, or open the card menu and choose Edit details.
- Update the name or description (the code is read-only).
- Click Save Changes.
7.3 Delete an Entity
- Open Entities.
- Find the required Entity.
- Open the card menu and choose Delete entity.
- Read the confirmation message carefully.
- Confirm the deletion.
Deletion is unavailable while the Entity still contains locks; remove or reassign them first.
Manage Local Admins
A Local Admin can manage users and distribute assigned Wallet Keys within a specific Entity.
Local Admins are managed inside the Entity edit window, not on a separate page.
8.1 Add a Local Admin
- Open Entities.
- Open the required Entity for editing (gear icon or Edit details).
- Scroll to the Manage Local Admins section.
- In Add Local Admin, select an existing Entity member or enter a new email address.
- Optionally enter the number of Wallet Keys to transfer.
- Click Add.
If the email address does not belong to an existing user, the user receives an invitation. You can also add an initial Local Admin while creating the Entity (see 7.1).
8.2 Transfer more Wallet Keys to a Local Admin
Use this to Transfer Wallet Keys to a Local Admin from your free balance.
- Open the Entity for editing.
- In Manage Local Admins, find the required Local Admin.
- Enter the quantity in the Wallet Keys field next to that Local Admin.
- Click Transfer.
8.3 Remove Local Admin permissions
- Open the Entity for editing.
- In Manage Local Admins, find the required Local Admin.
- Click the remove button.
- Confirm the action.
Removing Local Admin permissions does not delete the user account.
Manage users
Open Users to manage portal users within your entities. Users are shown in a searchable table.
9.1 Create a user
- Open Users.
- Click New User.
- Add a profile photo if needed (PNG or JPG, up to 6 MB).
- Enter the user's full name.
- Enter the user's email address (this becomes the login email).
- Enter a phone number if needed.
- Add one or more license plates if needed.
- Select the Entity.
- Choose whether to send a welcome email.
- Click Create User.
9.2 Edit a user
- Open Users.
- Find the required user.
- Click the edit (pencil) action.
- Update the required fields.
- Review Entity membership (select one or more entities).
- Update license plates or the profile photo if needed.
- Click Save Changes.
A user must remain linked to at least one Entity.
9.3 Search for a user
Use the search field to search by:
- Name
- Phone number
- License plate
9.4 Deactivate a user
Use this action when a user should no longer have active access.
- Open Users.
- Find the required user.
- Click the deactivate action.
- Read the confirmation message (deactivation removes lock access, disables portal login, and suspends the SmartKey user).
- Optionally enter a reason.
- Confirm the action.
9.5 Reactivate a user
- Open Users.
- Find the deactivated user.
- Click Reactivate User.
- Confirm the action.
Manage a user's access to a lock
From the Users section, you can manage access for individual locks directly in the user row.
- Open Users.
- Find the required user.
- Expand the Lock Access cell to show that user's locks.
For each lock that already has keys, use the Mobile and QR Intercom buttons shown in that lock's row.
10.1 Grant Mobile App access
- Click the Mobile button to Grant Mobile App Access, then confirm.
10.2 Revoke Mobile App access
- Click the Mobile button again to Revoke Mobile App Access, then confirm.
10.3 Grant QR Intercom access
- Click the QR Intercom button to Grant QR Intercom Access, then confirm.
10.4 Revoke QR Intercom access
- Click the QR Intercom button again to Revoke QR Intercom Access, then confirm.
If a lock shows No keys, assign a key first (see Section 11) before access buttons appear.
Manage digital keys
Open Keys (the Keys tab) to assign, update, share, or revoke digital keys. Keys are shown as cards.
11.1 Filter the key list
Use the filters to narrow the list by:
- Lock
- Status (Active, Expired, Revoked, Available)
- Type (Wallet Key, Physical Key, Intercom, Guest Key)
- User email
- Key UUID
11.2 Assign (bind) a key
- Open Keys.
- Click Bind Key. This opens the Assign Key wizard.
- Step 1 — Select the lock.
- Step 2 — Select an existing user, or click Create User to add one.
- Step 3 — Choose the key type:
- Wallet Key
- Physical Key
- QR Intercom
- Complete the options shown for the selected key type.
- Click the final button (Assign Key, Grant Access, or Continue to Programming, depending on the key type).
11.3 Assign a Wallet Key
Use this option for mobile Wallet access.
- In the wizard, choose Wallet Key.
- Enable Send email with key if you want the portal to email the Wallet link automatically.
- Click Assign Key.
Mobile App and QR Intercom access are granted automatically for that lock. If the user already has a reusable key identity, the portal may reuse it.
11.4 Assign QR Intercom access
Use this option when the user needs QR Intercom access without a Wallet Key.
- In the wizard, choose QR Intercom.
- Confirm the user and lock.
- Click Grant Access.
11.5 Update a key
Open a key card's actions menu. Depending on the key type, available actions may include:
- Set Validity (change valid-from / valid-until dates)
- Send Wallet Email
- Add to Another Lock (reuse the key UUID on a different lock)
- Revoke Key
You can also toggle Mobile and Intercom permission chips, and copy the Apple Wallet or Google Wallet link directly from the card.
11.6 Revoke a key
- Open Keys.
- Find the key.
- Open the actions menu and choose Revoke Key (or use the Revoke button on intercom cards).
- Confirm the action.
11.7 Use bulk actions
Select keys with the checkboxes to reveal the bulk action bar.
- Open Keys.
- Select the required keys (or use Select All / Select Filtered).
- Choose a bulk action:
- Bind (for available keys)
- Add to Lock (reuse key UUIDs)
- Send Emails (Wallet emails)
- Revoke
- Confirm and monitor progress until completion.
Create and manage temporary guest keys
Use a temporary guest key for time-limited visitor access.
12.1 Create a guest key
- Open Devices → Locks and click the Guest Key button on the required lock (the Guest Key quick action on the Dashboard works the same way).
- Confirm or select the lock.
- Set Valid From and Valid Until.
- Optionally set Max uses.
- Optionally enter an email recipient to email the link automatically.
- Click Create Guest Key.
12.2 Share a guest key
After creating the key, the result panel lets you:
- Copy the guest key link.
- Enter an email recipient and click Send Email (you can resend while the window is open).
12.3 Update a guest key
- Open Keys and find the guest key card.
- Click Update.
- Update the validity period.
- Save the change.
12.4 Delete a guest key
- Open Keys and find the guest key card.
- Click Delete.
- Confirm the action.
Manage Wallet Keys
Open the Wallet Keys tab (under Keys) to review Wallet Key availability.
13.1 Review your Wallet Key balance
Each owner card shows:
- Free (available) Wallet Keys
- Assigned Wallet Keys
- Total Wallet Keys
- A utilization / health indicator
13.2 Buy Wallet Keys
This option is available only to authorized users.
- Open the Wallet Keys tab.
- Click Buy Keys.
- Enter the required quantity.
- Click Checkout and complete payment.
Local Admins cannot buy Wallet Keys. They must contact their Community Manager.
13.3 Transfer Wallet Keys
When you are allowed to transfer keys:
- Open the Wallet Keys tab.
- In Transfer to Local Admin, select the recipient.
- Enter the quantity.
- Click Transfer Keys.
Program physical NFC keys
Open the Physical Keys tab (under Keys) to program and revoke physical NFC cards. You can filter the list by lock and status (Programmed, Pending, Failed, Revoked).
Before starting, confirm that a programmer reader or a lock's built-in programmer is available.
14.1 Program a new physical key
- Open the Physical Keys tab.
- Click Program Physical Key to open the Physical Key Wizard.
- Step 1 — Select the lock and the user.
- Step 2 — Select the programming device (or keep Use lock built-in programmer).
- Start flashing with the matching card-type button: Flash MIFARE Classic or Flash DESFire EV3.
- Tap the NFC card on the programmer when prompted.
- Wait for the device indication.
- Click Done in the portal.
- Confirm the card appears as programmed (the card serial is displayed).
14.2 Erase and reprogram a card
The wizard performs an erase step followed by a flash step when reprogramming.
- Start the programming wizard as above.
- Follow the erase step: tap the card, then click Done.
- Follow the flash step: tap the card again, then click Done.
14.3 Revoke a physical key
- Open the Physical Keys tab.
- Find the card.
- Click the revoke action.
- Optionally enter a revocation reason.
- Confirm the action.
Manage locks
Open Devices → Locks to add, control, and configure locks.
15.1 Lock statuses
A lock may be displayed as:
- Unclaimed
- Claiming
- Active
- Inactive
- Error
The actions available depend on the current status.
15.2 Add a lock
- Open Devices → Locks.
- Click Add Lock.
- Enter the lock serial number.
- Enter the Matter code.
- Click Add.
The lock is added to the currently selected Entity.
15.3 Open a lock remotely
- Open Devices → Locks.
- Find the active lock.
- Click Open.
- In the confirmation window, review the status and confirm with Open Lock.
If the button is temporarily unavailable, wait until the countdown ends before retrying.
15.4 Rename a lock
- Open Devices → Locks.
- Find the lock.
- Click the pencil (rename) icon next to the lock name.
- Enter the new name.
- Save the change.
15.5 Set a lock as a programmer reader
Use this when a compatible reader will be used to program NFC cards.
- Open Devices → Locks.
- Find the required lock.
- Open the lock actions menu.
- Choose Set as Programmer (or Unset Programmer to disable it).
15.6 Claim a lock
- Open Devices → Locks.
- Find the unclaimed lock.
- Open the actions menu and choose Claim Lock.
- Confirm the action.
15.7 Deactivate a lock
- Open Devices → Locks.
- Find the active lock.
- Open the actions menu and choose Deactivate Lock.
- Confirm the action.
15.8 Reactivate a lock
- Open Devices → Locks.
- Find the inactive lock.
- Click Reactivate.
- Confirm the action.
15.9 Delete a lock
- Open Devices → Locks.
- Find an eligible unclaimed or inactive lock.
- Click Delete.
- Read the warning carefully.
- Confirm with Delete Permanently.
This action may remove related data and may not be reversible.
15.10 Send a lock to another Entity
- Open Devices → Locks.
- Find the lock.
- Open the actions menu and choose Send to Another Entity.
- Select the target Entity.
- Confirm the transfer.
15.11 Remove a user from a lock
- Open Devices → Locks.
- Find the lock.
- Open the actions menu and choose User List.
- Find the required user.
- Click Remove.
- Confirm the action.
This removes the user's access associated with that lock.
Configure the weekly lock schedule
Use the scheduler to define access intervals for each day of the week.
16.1 Set the schedule
- Open Devices → Locks.
- Find the required lock.
- Click Scheduler.
- Select a day of the week.
- Add one or more time intervals.
- Repeat for the remaining days.
- Save the schedule. Use the save option that also syncs to the device when you want the change pushed to the lock immediately.
16.2 Refresh the device schedule status
- Open the lock scheduler.
- Click the refresh status action.
- Wait until the portal finishes loading the device information.
- Review the schedule shown in the portal.
Manage hubs
Open Devices → Hubs to manage Matter hubs.
17.1 Add a hub
- Open Devices → Hubs.
- Click Add Hub.
- Enter a hub name if needed.
- Select the Entity.
- Select the owner.
- Enter the hub UUID.
- Click Add Hub.
17.2 Refresh hub status
- Open Devices → Hubs.
- Click Refresh.
17.3 Rename a hub or change its role
- Open Devices → Hubs.
- Find the hub and open Edit Hub.
- Update the name, and/or use the Primary hub switch to set it as Primary or Secondary.
- Click Save.
17.4 Suspend a hub
- Open Devices → Hubs.
- Find the hub and choose Suspend.
- Enter the reason.
- Confirm the action.
17.5 Re-claim or move a hub
Use this action to assign the hub to another eligible Entity or owner.
- Open Devices → Hubs.
- Find the hub and choose Re-claim.
- Select the target Entity.
- Select the owner.
- Enter the reason.
- Confirm the action.
17.6 Commission a Matter device
- Open Devices → Hubs.
- Find the required hub and choose Commission Device.
- Optionally enter a device name.
- Enter the commissioning code.
- Confirm the action.
- Wait for the device to appear in the Matter tab.
Manage Matter devices
Open Devices → Matter to review devices commissioned through a hub.
18.1 Review Matter devices
The list may display:
- Device name or UUID
- Hub
- Entity
- Device type
- Status
- Assigned-to user
- Events
- Battery, signal, temperature, humidity, occupancy, or other available values
18.2 Assign a Matter device to a user
- Open Devices → Matter.
- Find the device.
- Click Assign.
- Select the user.
- Confirm the assignment.
If the button is disabled, review the message displayed by the portal.
18.3 Remove a user-device assignment
- Open Devices → Matter.
- Find the assigned device.
- Open the assignment details.
- Click Remove.
- Confirm the action.
18.4 View device events
- Open Devices → Matter.
- Find the device.
- Open its events or details.
- Review the available event history.
18.5 Remove a Matter device from the portal
- Open Devices → Matter.
- Find the device.
- Choose the delete/remove action.
- Confirm the action.
Important: removing the device from the portal may not factory-reset the physical device. Reset or decommission it separately when required.
Manage cameras
Open Cameras (the Cameras tab) to add and manage cameras. You can filter by status and choose the grid density.
19.1 Add a camera
- Open Cameras.
- Click Add Camera.
- Enter the camera name.
- Select the camera type.
- Select the Entity.
- Select the owner if needed.
- Enter the required connection details:
- For an RTSP camera, enter the RTSP URL.
- For an HTTP camera, enter the HTTP URL.
- For other supported camera types, enter the required login and password.
- Optionally select a linked lock from the same Entity.
- Click Create.
19.2 View a camera stream
- Open Cameras.
- Find the camera.
- Open its stream / view.
19.3 Update a camera
- Open Cameras.
- Find the camera.
- Click Edit.
- Update the required fields.
- Click Save.
19.4 Link a camera to a lock
- Open Cameras.
- Find the camera.
- Click Link.
- Select an active lock from the same Entity.
- Confirm the action.
19.5 Unlink a camera from a lock
- Open Cameras.
- Find the camera.
- Choose the unlink action.
- Confirm the action.
19.6 Disable a camera
- Open Cameras.
- Find the camera.
- Choose Disable.
- Enter the reason.
- Confirm the action.
19.7 Delete a camera
- Open Cameras.
- Find the camera.
- Choose Delete.
- Confirm the action.
Manage camera roles
Camera roles define which users can access selected cameras and what they are allowed to do.
20.1 Create a camera role
- Open Cameras.
- Open the Camera Roles tab.
- Click Create Role.
- Enter the role name.
- Enter the description.
- Select the Entity.
- Click Create Role.
20.2 Add a camera to a role
- Open the required camera role.
- Click Add Camera.
- Select a camera from the same Entity.
- Select at least one permission.
- Click Add.
20.3 Remove a camera from a role
- Open the camera role.
- Find the camera.
- Choose Remove.
- Confirm the action.
20.4 Assign a user to a camera role
- Open the required camera role.
- Click Add User.
- Select a user from the same Entity.
- Confirm the assignment.
20.5 Remove a user from a camera role
- Open the camera role.
- Find the user.
- Choose Remove.
- Confirm the action.
20.6 Delete a camera role
- Open the Camera Roles tab.
- Find the role.
- Choose Delete.
- Confirm the action.
Review Activity logs
Open Logs → Activity to review access events.
21.1 Routine monitoring
By default, the activity list focuses on the most relevant access events, such as:
- Key accepted
- Lock unlocked
21.2 Advanced details
Enable the Advanced toggle in the filter bar when you need more detailed event information.
21.3 Filter Activity logs
Available filters may include:
- Lock
- Event type
- Date range (from / to)
- Key UUID
- User email
- Location
- Advanced toggle
Apply the filters to update the list.
21.4 Export Activity logs
- Open Logs → Activity.
- Apply the required filters.
- Click Export CSV.
- Save the file.
Review Audit logs
Open Logs → Audit to review administrative actions performed in the portal.
22.1 Filter Audit logs
Available filters may include:
- Search (by user or description)
- Operation type
- Status (state)
- Lock
- User
- Date range (from / to)
22.2 Sort and paginate results
- Click a sortable column heading (Timestamp, Operation, Status) to sort.
- Select the number of rows per page if needed.
- Use the pagination controls to move between pages.
22.3 View details
- Find the required operation.
- Click the row to open its details.
- Review the available information.
22.4 Export Audit logs
- Apply the required filters.
- Click Export CSV.
- Save the file.
Settings
Open Settings to manage your profile, subscription, notifications, access requests, and billing. Each area is a tab at the top of the page.
23.1 Update your profile
- Open Settings → Profile.
- Update your full name, phone, or mobile number.
- Click Save.
Your email address is displayed but cannot be changed from this page.
23.2 Review subscription information
- Open Settings → Subscription.
- Review your current plan and status.
- Review available upgrade or shop links if displayed.
23.3 Review usage
The Subscription tab also shows usage meters for entities, locks, and users.
Pay attention to warning indicators when you are close to a limit.
23.4 Configure notifications
- Open Settings → Notifications.
- Enable or disable the available toggles:
- Key Pool Alerts
- Lock Activity
- Subscription Reminders
Changes take effect when you toggle each option.
23.5 Review billing
- Open Settings → Billing.
- Review invoices.
- Open an invoice PDF from the list.
If the invoice cannot be opened, sign in again or contact your administrator.
Review and approve access requests
Depending on your role, you may receive requests from installers or Community Managers.
24.1 Approve a request
- Open Settings → Access Requests.
- In Incoming Requests, find the request.
- Review the request type, Entity or lock list, requested duration, and reason.
- Adjust the approval duration if this option is displayed.
- Click Approve.
24.2 Reject a request
- Open Settings → Access Requests.
- In Incoming Requests, find the request.
- Click Reject.
- Confirm the action.
24.3 Review submitted requests
In Settings → Access Requests, review the Submitted Requests list to check whether your own request is pending, approved, or rejected.
Request temporary installer access
Use this page when you need temporary access to selected locks owned by another user.
- Open the installer access request page.
- Enter the owner's email address.
- Enter one or more lock serial numbers.
- Enter the requested duration.
- Enter the reason.
- Submit the request.
- Wait for the owner to approve or reject it.
- Check the submitted requests list for the status.
Request Entity-management access
Eligible Community Managers can request access to another Entity.
- Open the Entity-management access request page.
- Enter the owner's email address.
- Enter the Entity code.
- Submit the request.
- Wait for approval.
- Check the submitted requests list for the status.
Troubleshooting
A menu section is missing
The section may not be included in your role. Contact your administrator if you believe you need access.
Data from the wrong Entity is displayed
Use the Entity selector and choose the correct Entity. Wait for the page to refresh.
A button is disabled
Read the message displayed by the portal. The action may require:
- A different role
- An active user
- An active lock
- Available Wallet Keys
- A valid device status
- A selected Entity
- A completed prerequisite step (for example, a lock must have keys before access buttons appear)
A remote lock action fails
Check the lock status and last activity time. Retry after the countdown ends if the portal temporarily blocks repeated commands.
A physical card does not program correctly
Confirm that:
- The correct lock and user are selected.
- The correct programmer device is selected.
- The correct card type was chosen (MIFARE Classic or DESFire EV3).
- The card was tapped on the programmer.
- You clicked Done after the device indication.
An invoice does not open
Sign in again and retry. If the problem remains, contact your administrator.
Quick checklist for a new administrator
- Register your account and claim the first lock.
- Sign in to the SPK Portal.
- Confirm the current Entity.
- Review the Dashboard.
- Create additional Entities if needed.
- Add Local Admins.
- Create users.
- Add locks (Devices → Locks) and hubs (Devices → Hubs).
- Assign Wallet Keys, QR Intercom access, or physical keys.
- Configure lock schedules if needed.
- Add Matter devices and cameras if used.
- Review Activity and Audit logs.
- Configure notifications.
- Review usage and Wallet Key balance regularly.
Important notes
- Available sections depend on your role and permissions.
- Always confirm the selected Entity before making changes.
- Review confirmation messages carefully before deleting resources.
- Local Admins can receive Wallet Keys but cannot buy them.
- Removing a Matter device from the portal may not reset the physical device.
- Use temporary guest keys for visitor access instead of permanent user keys.