To create users: An admin user may create other users, or edit user information.
Users must be created by an admin. There is no way for users to sign up themselves under your account (by design).
To create users:
1. Navigate to the user management page under My Account -> Users.
2. Click Create User in the top left of the window.
3. Fill in at least all fields marked with an asterisk (required). (If using Service Reviews, the technician email must match their email in NearbyNow.)
4. Select whether or not the user is a technician. Note that technician users count towards your overall subscription license total unless they are used as placeholder technicians.
5. If a user is a technician, you will need to select any relevant service lines, which correspond to his or her ability to complete a job for a given trade.
6. Click Save.
7. Assign relevant standard roles to the user. Roles control what the user can do. There are a series of default roles that can be selected for a user. Select the role or combination of roles that best fit the user you've created. If you need permission that varies from the standard roles, you may wish to create and assign custom roles.
8. Add a user profile photo if applicable. We highly suggest adding photos of your techs for use on the dispatch board and communications to customers.
9. Configure user notification settings. More details on managing notifications are available in this article.
10. If the user is a tech and you're using labor items in your account, you can set up labor costs per item for each tech. Open the 'Labor Rates' section and type a cost for each labor item for that tech.
11. Repeat these steps for each office or tech user in your company.
To see more info on user creation including user management FAQ, see below.
NOTE: Users are not notified that you have created an account for them. You will need to do so using whichever method you desire.
To add custom fields to users, such as an internal employee ID # or a tech certification number:
- Click on the desired user.
- Click on the "Edit User" button.
- Enter the desired information in the "User Details" Section.
If including information such as licensing and technician certificate numbers are important to share with your customers, the detailed information about all the technicians assigned to a job can be prefilled onto your job paperwork PDFs by using the 'job_tech_details' fillable paperwork field.
To change user passwords:
For security reasons, no one, not even ServiceTrade Support, may view other's passwords. If you have the admin users role, you are able to change user passwords on their behalf.
To change a user's password:
- Hover over My Account up top
- Click "users"
- Click on the name of the user you wish to edit
- Click the blue "change password" button on the right of the screen.
You may have them enter the desired password if they are present, enter it on their behalf, or enter a temporary password for them.
Users may reset their own passwords at https://app.servicetrade.com/auth/recover.
Technician Users that count towards your subscription license total are defined in the Master Subscription Agreement as follows:
“Technician Users” means individuals authorized by You to use the Services, who have been
supplied user identifications and passwords by You (or by Us at Your request), who can be
assigned to deliver jobs, and who are eligible to use the mobile application to review and report
job status information. Technician Users may include but are not limited to Your employees,
consultants, contractors and agents, and third parties with which You transact business.
In ServiceTrade, any user that is marked as active, has used ServiceTrade in the last 30 days, and has the "User is a Technician" field checked meets these criteria and will count towards your subscription license total. If a user has the "User is a Technician" field checked, is marked as active, and has not used ServiceTrade in the last 30 days, they will be considered a placeholder technician.
To view a list of your technician users, you can navigate to your company page, open the "Users" accordion, and search the term "tech". To export a list of your technician users, navigate to your user list and use the "Export to Spreadsheet" option found in the top right. In the export, you'll find a column called "is_tech" that indicates which users are technicians.
Placeholder technicians are currently a free type of user that do not count towards your subscription. These users can be used for a variety of purposes such as scheduling equipment to be used on jobs, tracking office-user assignment to appointments, or tracking additional appointment statuses. Any user in ServiceTrade marked as a technician is considered a placeholder technician if no one logs in with that user's credentials and it is not used to complete actions in the web or mobile applications in the last 30 days. This feature provides your company with the flexibility to assign these users to jobs for informational purposes.
If anyone in your company has logged in as a technician user, completed actions in the web or mobile apps in the last 30 days as that user, and that user is marked as active, the technician user will not be considered a placeholder technician and will be counted towards your subscription license total.
How do I change a username?
- There is no way to do this from within your account.
- Open a support ticket by emailing email@example.com, letting us know the old username and the desired new username, and will do our best to accommodate.
- It is NOT recommended to change usernames when replacing personnel. When deactivating a user, you may transfer their assigned jobs and services to someone else. Contact support to move over assigned quotes. We recommend that user accounts be kept isolated and not shared, even during staff transitions.
How do I change a tech's office?
- Go to My Account -> Users.
- Click on the tech you wish to change.
- Click "edit".
- Change their default office.
ServiceTrade won't let me have the username that I want. It says "username is unavailable" but I don't have anyone in my account with that username.
- Usernames must be unique across ServiceTrade, not just your account.
- Similar to a service like Gmail, if you desire a simple username such as jsmith, it is likely taken, where mycompany.jsmith or firstname.lastname@example.org (email address as a username) is almost certainly available.
- Try another username.
What is a good practice/schema for usernames?
While NightDragonSupremeOfTheEverWinterForest is a sweet username, we recommend using your email as your username.
One of my users got locked out from too many failed login attempts. How do I unlock them?
- They may try to reset their password at app.servicetrade.com/auth/recover.
- As an Admin, you may go to their user page within ServiceTrade and reset their password from the back end.
What password guidelines do you recommend?
Strong passwords and password rotation business rules that you enforce internally are the best front-line defense for most forms of data leakage.
Can I log into ServiceTrade with my Google / Office 365 / some other username/password?
We don't support OAuth or other single-sign-on systems at this time.
Can I use my Active Directory credentials to log into ServiceTrade?
We don't natively integrate with any AD systems, and it's unlikely that we will do so in the foreseeable future. However, you can create, change, and assign/remove roles from users via our user API endpoint, so it is possible for you to create scripts on your AD server (or whatever your user management platform is) that provision and manage ST users in response to changes that you make at the AD level via our user API.
Can I restrict my users' access times?
Authorized access time-of-day management is also unlikely to be added to ServiceTrade in the foreseeable future. However, you could probably achieve something similar with an API script on your AD server that will deactivate, and/or "fuzz" the passwords of, users at the beginning of their locked-out time period (6 pm, say), then reactivate (or "un-fuzz") them when you intend for access to be restored.
Where can I see a user's activity?
User login activity itself isn't auditable by end-users, but most significant actions (changes to records, the creation of new records, etc) are recorded on the History screen. If you're looking for a more systematic way to review changes to records, our history API endpoint gives access to this. You could use this in a batch-oriented way (once a day, month, etc) or in real-time using a webhook listener and a middleware platform such as Zapier, using some business logic that recognizes anomalous behavior and then puts those history records in a Google Sheet/emails them to you/whatever.
What should I do in ServiceTrade if a staff member is leaving permanently, or no longer needs access for some other reason?
- As an admin, view their user page and change their password right away if security is a concern.
- Search for all quotes assigned to them and reassign, if applicable.
- Search for all jobs where they are the job owner and reassign, if applicable.
- If a tech, when deactivating there is an option to reassign both open jobs as well as replacing them / removing them as the preferred tech on recurring services.
- View their user page, click edit user, and change their status to "inactive".