Creating and Managing Users

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.

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:

1. Click on the desired user.
2. Click on the "Edit User" button.
3. 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:

1. Hover over My Account up top
2. Click "users"
3. Click on the name of the user you wish to edit
4. 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.

FAQ:

How do I change a username? 

• There is no way to do this from within your account.  
• Open a support ticket by chatting with us (bottom right of this screen) or by emailing support@servicetrade.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.
• Save.

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 jsmith@mycompany.com (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?

1. As an admin, view their user page and change their password right away if security is a concern.
2. Search for all quotes assigned to them and reassign, if applicable.
3. Search for all jobs where they are the job owner and reassign, if applicable.
4. 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.
5. View their user page, click edit user, and change their status to "inactive".