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.
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.)
To use the Account Manager API, you must request access by contacting your Trimble Maps sales representative or our Sales team.
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.
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.
Add a user with a POST request to
/usersthat includes an
externalIdand other optional fields.
Then, as your needs, devices or staffing change over time, you can:
Repeat Step 3 above to assign those licenses you have removed to new users.