In addition to the default administrative roles available in the Samsara dashboard, you can customize your own roles and permissions for administrators.
To view permissions or add a custom role, reference the following topics:
After you create a custom role, you can assign it when you create new administrative users. Using a custom role type and a tag in combination will limit administrative access to the features allocated within their role, to manage or view the drivers, vehicles, and other devices assigned the tag.
To add a custom role:
-
Select the Settings icon ( ) at the bottom of your Fleet menu to view dashboard settings.
-
In Organization > Users & Roles > Roles, select + Add role.
-
Click into the Name your role field and enter a descriptive name.
-
Enable View or Edit permissions for each section or, for more granular permissions, expand the section and select the permissions individually. See Permissions for Custom Roles for granular detail of each permission.
-
Save the custom role.
For each role that you create, you can assign unique levels of administrative access and granular permissions required for specific workflows. You can assign basic or custom permissions for each user including view and edit capabilities for certain categories. Samsara frequently updates categories and permissions to optimize sitewide usability.
The following table lists the granular permissions that you can assign to a custom role.
Permission |
Access |
Description |
Drivers |
View |
Drivers and driver settings, Unassigned HOS |
Edit |
Driver settings, and assign or annotate Unassigned HOS |
|
Driver Logs |
View |
Compliance pages and HOS logs |
Edit |
HOS logs |
|
Driver Logs - Ignore |
Edit |
|
Unassigned Segments |
View |
Unassigned segments |
Edit |
Annotate and assign unassigned segments |
|
Gateways |
View |
Vehicle, asset, and industrial gateways |
Edit |
Edit and remove gateway settings and edit vehicle gateway from vehicle page |
|
Gateway Health |
View |
Gateway health issues and reports |
Location data |
View |
View location of vehicles, trailers, and assets on fleet overview, dispatch, and proximity pages |
Live Share |
Copy |
Existing live share links |
Edit |
Create and edit live share links |
|
Sensors |
View |
View environment page, sensors throughout the dashboard, and sensors in settings |
Edit |
Edit sensor configurations in settings |
|
Alerts |
View |
View and download alerts from the alerts incident tab |
Edit |
Edit, create and remove alerts from the alerts configure tab |
|
Messages |
View |
View and print messages Additional permissions required: Essentials > View: Drivers |
Edit |
Create and send messages Additional permissions required: Essentials > View: Drivers |
|
Reports / General |
View |
View reports page, trip history, time on site and equipment report |
Custom Reports |
View |
Custom reports This permission also requires access to the Entire Organization during role assignment. |
Edit |
Custom reports This permission also requires access to the Entire Organization during role assignment. |
|
Reefer Control |
Edit |
Remotely control reefer on/off status, run mode, and set point |
Driver Qualifications |
View |
Driver qualifications |
Edit |
Create, Update, and Delete Driver Qualifications |
|
Driver Qualification Templates |
Edit |
Create Driver Qualification Templates Additional permissions required: Essentials > Driver Qualifications > View/Edit |
Map Editor |
View |
Data in the Map Editor |
Edit |
Edit or Apply new overrides in Map Editor |
|
Manage Routes |
View |
View routes page, dispatch page, route reports, and download routes. Additional permissions required: Essentials > View: Location Data |
Edit |
Create, edit and remove routes |
|
Maintenance Log |
View |
Maintenance features |
Edit |
Create and edit schedules, DVIRs and logs. Additional permissions required: Essentials > View: Gateways |
|
Inbox & Report |
View |
Safety Inbox, Safety Report, Dash Cam pages, Visual Review, and other applicable pages, and view videos of events surfaced in the Safety Inbox. Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, and Reports |
Edit |
Safety events and add labels on events, add safety managers, assign drivers, and add comments Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, and Reports |
|
Dismiss Safety Events |
Edit |
Can change coaching status of a safety event to Dismissed Additional permissions required: Safety > View: Inbox & Report |
Triage Safety Events |
Edit |
Can change the coaching status of a safety event to Needs Review, Needs Coaching, or Needs Recognition Additional permissions required: Safety > View: Inbox & Report |
Review Safety Events |
Edit |
Can change the coaching status of a safety event to Reviewed Additional permissions required: Safety > View: Inbox & Report |
Coach Safety Events |
Edit |
Can change the coaching status of a safety event to Coached or Recognized Additional permissions required: Safety > Edit: Inbox & Report |
Add Behavior Labels |
Edit |
Add behavior labels to safety events Additional permissions required: Safety > View: Inbox & Report |
Remove Behavior Labels |
Edit |
Remove behavior labels from safety events Additional permissions required: Safety > View: Inbox & Report |
Comment on Safety Events |
Edit |
Add comments on safety events Additional permissions required: Safety > View: Inbox & Report |
Safety Event Assignment |
Edit |
Assign coaches and drivers to safety events Additional permissions required: Safety > View: Inbox & Report |
Safety Event Access - Coach |
View |
View safety events for all coaches. Additional permissions required:
|
Safety Event Access - Panic Button |
View |
View dash cam videos and trip details for panic button events. To install the Panic Button and configure Panic Button video retrieval and alerts, see Panic Button. Additional permissions required: Essentials > View: Drivers, Gateways, and Location Data |
Safety Event Access - Driver |
View |
Safety event review in the Safety Inbox based on driver assignment. Additional permissions required: Safety > View: Inbox & Report |
Safety Event Access - Vehicle |
View |
Safety event review in the Safety Inbox based on vehicle assignment. Additional permissions required: Safety > View: Inbox & Report |
Video Download |
View |
Download video from events surfaced in the Safety Inbox Additional permissions required:
|
Mulitcam Installation |
View |
Multicam devices |
Edit |
Multicam devices and check activated multicam assets |
|
Dash Cam Installation |
View |
Check dash cam installation (take picture functionality) Additional permissions required: Essentials > View: Gateways, Location Data |
Coaching |
View |
Coaching page and other users Additional permissions required:
|
Edit |
Coach drivers, edit coaching status, and add coaching comments Additional permissions required:
|
|
Video Retrieval |
View |
Video retrievals and video library Additional permissions required:
|
Edit |
Request video retrieval. Additional permissions required:
|
|
Camera Health |
View |
View Camera Health page. Additional permissions required:
|
Edit |
Share and revoke driver QR Codes Additional permissions required: Essentials > View: Drivers |
|
View |
Initiate and watch live stream video footage from vehicles on trips Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, and Reports |
|
Driver Assets |
View |
View any driver-facing assets |
External Assets |
View |
View any external-facing assets |
Excuse Speeding |
View |
Excuse speeding on the vehicle show page |
Mobile Experience Management |
View |
View access to all MEM pages such as devices and policies associated with the Samsara MEM solution. Does not permit any device commands such as to initiate a remote session, restart, reset, or edit device name. Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, and Messages |
Edit |
Edit access to all MEM pages such as devices and policies associated with the Samsara MEM solution. Enables you to perform device commands such as to initiate a remote session, perform a restart or factory reset, edit the device name, and lock the device. Additional permissions required: Essentials > Edit: Drivers, Gateways, Location Data, and Messages |
|
Users, Roles, and Tags |
View |
Users, roles, and tags |
Edit |
Create, edit, and delete users, roles, and tags |
|
Additional Admin Settings |
View |
View general settings, sensors, gateways, HOS/DVIR, trailers & assets and activity log in settings This permission also requires access to the Entire Organization during role assignment. |
Edit |
Edit general organization settings This permission also requires access to the Entire Organization during role assignment. |
|
Device Activation |
Edit |
Activate devices Additional permissions required: Essentials > View: Gateways |
Device Deactivation |
Edit |
Deactivate devices Additional permissions required: Essentials > View: Gateways |
Device Returns |
View |
View devices that need replacement Additional permissions required:
|
Edit |
Return devices that need replacement Additional permissions required:
|
|
Scheduled Reports |
View |
Scheduled reports |
Edit |
Create, edit, and remove scheduled reports |
|
Alert contacts |
View |
Alert contacts |
Edit |
Create, edit, and remove alert contacts |
|
Addresses / Geofences |
View |
Addresses |
Edit |
Create, edit, and remove addresses |
|
Feature Management |
View |
New available features Additional permissions required: Settings > View: Users, Roles, and Tags This permission also requires access to the Entire Organization during role assignment. |
Edit |
Enable / disable available features for any accessible user |
|
Single Sign on |
View |
Single sign on settings This permission also requires access to the Entire Organization during role assignment. |
Edit |
Create, edit, and delete single sign on settings This permission also requires access to the Entire Organization during role assignment. |
|
Documents |
View |
Documents |
Edit |
Edit, archive, and delete documents |
|
Document Templates |
Edit |
Create and edit document templates Additional permissions required: Documents > Edit: Documents |
API Tokens |
View |
API token identities (with API tokens blurred). This permission also grants access to view Users and Roles This permission also requires access to the Entire Organization during role assignment. |
Edit |
View and create API tokens Additional permissions required: Settings > Edit: Users, Roles, and Tags This permission also requires access to the Entire Organization during role assignment. |
|
App Marketplace |
View |
App marketplace, integrations, and information about your developer account This permission also requires access to the Entire Organization during role assignment. |
Edit |
Install third party applications and configure integrations This permission also requires access to the Entire Organization during role assignment. |
|
Third Party Applications |
View |
Third party applications This permission also requires access to the Entire Organization during role assignment. |
Edit |
Create third party applications for your organization This permission also requires access to the Entire Organization during role assignment. |
|
Webhooks |
View |
Webhooks |
Edit |
Create, edit, and delete webhooks |
|
Developer Metrics |
View |
API requests on the developer metrics page |
Fuel Purchases |
View |
Fuel Purchases and Fuel Purchase details |
Edit |
Upload, edit, and delete Fuel Purchases and Fuel Purchase details |
|
Fuel Cards |
View |
Fuel Card Vendors |
Edit |
Add, edit, and delete Fuel Card Vendors |
|
Fuel Costs |
View |
Fuel Costs |
Edit |
Create and edit Fuel Costs |
|
Account Management (Billing, licensing, purchases, orders, and exchanges) |
||
Billing |
View |
Billing, payments, and invoices This permission also requires access to the Entire Organization during role assignment. |
Edit |
Payment method This permission also requires access to the Entire Organization during role assignment. |
|
Billing Roles |
Edit |
Create, delete, or edit roles with Billing permissions This permission also requires access to the Entire Organization during role assignment. Additional permissions required: Settings > Edit: Users, Roles, and Tags |
Orders Exchanges |
View |
Orders and exchange records on order history page This permission also requires access to the Entire Organization during role assignment. |
Edit |
Make purchases and submit warranty exchanges |
|
Log in as Another User |
Edit |
Log in to the dashboard as another user in the organization |
Override camera config fields |
Edit |
Set camera configuration fields using JSON configuration overrides. |
Vehicle Endpoints (Permissions for managing API vehicles endpoints) |
||
Allow calls to address endpoints |
View |
Allows calls to get GET address endpoints |
Edit |
Allow calls to POST, PUT, PATCH, UPDATE, and DELETE address endpoints |
|
Manage access to driver training assignments |
View |
View training data Additional permissions required:
|
Edit |
Assign, edit, and delete assignments Additional permissions required:
|
|
Fleet Security Manager |
Edit |
Allows user to configure organization wide immobilization configurations |
Immobilization Manager |
Edit |
Allows user to remotely immobilize a vehicle (immobilization depends on the speed threshold) |
Comments
0 comments
Please sign in to leave a comment.