Account Manager Introduction
The Account Manager is a web tool that allows you to distribute and manage the product licenses your fleet has purchased for CoPilot with ActiveTraffic, MileOn, or both. You can create lists of users (either drivers, devices or vehicles), remotely distribute software licenses to those users, and then re-assign your licenses as needed when your devices or staffing change.
The Account Manager API is a RESTful API that provides endpoints for managing licenses and licensed users. Trimble Maps partners can also use this API to set up Account Manager for their customers.
What Can You Do With The Account Manager API?
With this API, your company’s Account Manager administrator can:
- Add and remove licensed users. (Individual or in bulk. Up to 1,000 users can be added per API call.)
- Add and remove licensed products from users. (Individual or in bulk. Up to 1,000 users can be assigned licenses per API call.)
Getting Started
To use the Account Manager API, you must request access by contacting your Trimble Maps sales representative or our Sales team.
Account Manager Terminology
In the Account Manager, you may assign a license for CoPilot or MileOn to a person (driver), a device that is installed directly in a truck, or a handheld device. To support this variety of uses, we provide a user identifier field called External Id.
External ID is the value that will be used as the User ID to log into CoPilot or MileOn on a device, and it should uniquely identify the user (driver, device or vehicle). For example, an External ID could be a company issued device ID, driver ID, email address, phone number, device descriptor, or vehicle number—whatever works best for your fleet. It is the only required field when adding a new user in the Account Manager.
Resource URL
https://accounts-api.trimblemaps.com
Account Manager API Flow
For Fleets Managing Their Own Licenses
To create a new user and assign licenses within your account you would:
-
Authenticate your account and get an
authToken
, which should be passed as the Bearer token in each subsequent request. When requesting anauthToken
, thealias
parameter is not required if you are authenticating on behalf of your own fleet in order to retrieve or update your own information. Thealias
parameter is used by Trimble Maps partners to authenticate and retrieve or update information on behalf of their customers. Partners can use the/company-list
endpoint to retrieve thealias
for each of their customers. -
Add a user with a POST request to
/users
that includes anexternalId
and other optional fields. -
Assign products to a single user with a POST request to
/license/{productId}
or assign products to a list of users with a POST request to/license/{productId}/bulk
.
Then, as your needs, devices or staffing change over time, you can:
-
Modify a user’s information with a PUT request to
/users/{externalId}
or delete a user with a DELETE request to/users/{externalId}
. -
Remove a license from a single user with a DELETE request to
/license/{productId}
or remove licenses from a list of users with a DELETE request to/license/{productId}/bulk
. -
Repeat Step 3 above to assign those licenses you have removed to new users.