Custom Roles

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:

Add a Custom Role
Permissions for Custom Roles

Add a Custom Role

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.

Permissions for Custom Roles

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.

Essentials (Basic Permissions)
Routes (Create and Manage Routes)
Maintenance (Inspection reports and defects)
Safety (View Camera Assets, Manage Safety Events)
Cameras (Manage access to videos & images)
Speeding (Manage device speeding)
MDM (Mobile Device Management)
Settings (Organizational Settings)
Documents (Document Settings)
API & Integrations (API Integration Settings)
Fuel (Fuel Settings)
Account Management (Billing, licensing, purchases, orders, and exchanges)
Advanced (Advanced features for administrators)
Device Configs (Permissions for managing device configs)
Vehicle Endpoints (Permissions for managing API vehicles endpoints

Permission	Access	Description
Essentials (Basic Permissions)
Drivers	View	Drivers and driver settings, Unassigned HOS
Drivers	Edit	Driver settings, and assign or annotate Unassigned HOS
Driver Logs	View	Compliance pages and HOS logs
Driver Logs	Edit	HOS logs
Driver Logs - Ignore	Edit	Ignore driving segments
Unassigned Segments	View	Unassigned segments
Unassigned Segments	Edit	Annotate and assign unassigned segments
Gateways	View	Vehicle, asset, and industrial gateways
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
Live Share	Edit	Create and edit live share links
Sensors	View	View environment page, sensors throughout the dashboard, and sensors in settings
Sensors	Edit	Edit sensor configurations in settings
Alerts	View	View and download alerts from the alerts incident tab
Alerts	Edit	Edit, create and remove alerts from the alerts configure tab
Messages	View	View and print messages. Additional permissions required: Essentials > View: Drivers
Messages	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.
Custom Reports	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
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
Map Editor	Edit	Edit or Apply new overrides in Map Editor
*Routes (Create and Manage Routes)*
Manage Routes	View	View routes page, dispatch page, route reports, and download routes. Additional permissions required: Essentials > View: Location Data
Manage Routes	Edit	Create, edit and remove routes
*Maintenance (Inspection reports and defects)*
Maintenance Log	View	Maintenance features
Maintenance Log	Edit	Create and edit schedules, DVIRs and logs. Additional permissions required: Essentials > View: Gateways
Safety (View Camera Assets, Manage Safety Events)
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
Inbox & Report	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 > View: Inbox & Report
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: Essentials > View: Drivers, Gateways, Location Data, Reports Safety > View: Inbox & Report
Mulitcam Installation	View	Multicam devices
Mulitcam Installation	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: Essentials > View: Drivers, Gateways, Location Data, Reports Safety > View: Inbox & Report
Coaching	Edit	Coach drivers, edit coaching status, and add coaching comments Additional permissions required: Essentials > Edit: Drivers, Gateways, Location Data, Reports Safety > Edit: Inbox & Report
Video Retrieval	View	Video retrievals and video library Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, Reports Safety > View: Inbox & Report
Video Retrieval	Edit	Request video retrieval. Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, Reports Safety > View: Inbox & Report
Camera Health	View	View Camera Health page. Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, Reports Safety > View: Inbox & Report Settings > View: Additional Admin Settings
Cameras (Manage access to videos & images)
Live Streaming	View	Initiate and watch live stream video footage from vehicles on trips Additional permissions required: Essentials > View: Drivers, Gateways, Location Data, Reports
Driver Assets	View	View any driver-facing assets
External Assets	View	View any external-facing assets
*Speeding (Manage device speeding)*
Excuse Speeding	View	Excuse speeding on the vehicle show page.
*MDM (Mobile Device Management)*
Mobile Device Management	View	View access to all MDM pages such as devices and policies associated with the Samsara MDM solution. Does not allow for 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
Mobile Device Management	Edit	Edit access to all MDM pages such as devices and policies associated with the Samsara MDM solution. Allows 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
Settings (Organizational Settings)
Users, Roles, and Tags	View	Users, roles, and tags
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.
Additional Admin Settings	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
Scheduled Reports	View	Scheduled reports
Scheduled Reports	Edit	Create, edit, and remove scheduled reports
Alert contacts	View	Alert contacts
Alert contacts	Edit	Create, edit, and remove alert contacts
Addresses / Geofences	View	Addresses
Addresses / Geofences	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.
Feature Management	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.
Single Sign on	Edit	Create, edit, and delete single sign on settings This permission also requires access to the Entire Organization during role assignment.
Documents (Document Settings)
Documents	View	Documents
Documents	Edit	Edit, archive, and delete documents
Document Templates	Edit	Create and edit document templates Additional permissions required: Documents > Edit: Documents
API & Integrations (API Integration Settings)
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.
API Tokens	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.
App Marketplace	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.
Third Party Applications	Edit	Create third party applications for your organization This permission also requires access to the Entire Organization during role assignment.
Webhooks	View	Webhooks
Webhooks	Edit	Create, edit, and delete webhooks
Developer Metrics	View	API requests on the developer metrics page
Fuel (Fuel Settings)
Fuel Costs	View	Fuel Costs
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.
Billing	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.
Orders Exchanges	Edit	Make purchases and submit warranty exchanges
Advanced (Advanced features for administrators)
Log in as Another User	Edit	Log in to the dashboard as another user in the organization
Device Configs (Permissions for managing device configs)
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
Allow calls to address endpoints	Edit	Allow calls to POST, PUT, PATCH, UPDATE, and DELETE address endpoints

Add a Custom Role

Permissions for Custom Roles

Comments

Articles in this section

Add a Custom Role

Permissions for Custom Roles

Related articles

Articles in this section