Frontline Inventory & Help Desk Management
Frontline Inventory & Help Desk Management

Provisioning Asset Management in Mosyle

Print

This guide shows Mosyle administrators how to create an API-based administrator, generate an API token, and authorize Frontline Asset Management (AM) to run a nightly, read-only inventory sync.

Prerequisites

  • Mosyle admin rights – You must have full administrator access in Mosyle, including permission to create users, roles, and API tokens.
  • Mosyle subscription – “Mosyle Manager Premium” is required to enable API integration.
  • Asset Management access – You must be a District Administrator in Frontline Asset Management to configure integrations.

Step-by-Step Configuration

Note: Mosyle’s user interface changes from time to time, but the essentials remain the same: create an API-only administrator, generate an API token that allows read access to devices, then enter the Mosyle URL and those credentials in Frontline Asset Management. The nightly sync will run successfully once the connection is verified.

Create an API-Based Administrator

  1. Sign in to Mosyle Manager at https://myschool.mosyle.com (or https://managerapi.mosyle.com).
  2. In the bottom navigation bar, select MySchool.
  3. Click Create new administrator.
  4. Fill in each required field:
    • Name: e.g. Frontline Asset Management (or another clear identifier)
    • User ID: e.g. Frontline Asset Management (must be unique; match the Name for simplicity)
    • Email: e.g. assetmgmt_api@yourdistrict.org (or another unique address in your domain).
    • Managed Apple ID: leave blank
    • Password: leave blank; you will reset it in the next step
    • Account Type: Leader
  5. Click Save to create the administrator. Record this email address.
  6. (Optional but recommended) From the "Edit" screen, click Limit user permissions > New Role and create an API-limited access-only role.
    limit role access.png
  7. After the account is created, click Edit > Reset password, set a strong random password, and record it.
  8. If the API-limited access-only role role was created, open Advanced Options:
    • Leave "Remove all restrictive profiles" unchecked.
    • Check Limit user permissions, then select the limited role with only API integration rights.
      limit api access.png
  9. Click Save.

Authorize an API Token in Mosyle

add new mosyle access token.png
  1. Still under MySchool, click Integrations > Mosyle API Integration.
  2. Click Add new token.
  3. On the Edit API Integration form:
    • Profile Name: e.g., Frontline Asset Management
    • Access Method: Public (do not restrict by server IP)
    • Endpoints: Allow all current and future endpoints
  4. Click Save.
  5. Copy the access token. It appears once; store it securely alongside the email and password.

Configure in Asset Management

  1. Navigate to Management > Integration Settings > Mosyle Integrations.
  2. Enter the credentials you recorded:
    • Access Token
    • API Username/Email
    • API User Password
  3. Click Save. Status text shows "Ready to synchronize…."
  4. Click Initiate One-Time Sync to verify the connection and import your first dataset.
manage integration settings.png

Troubleshooting Tips

  • Invalid credentials: Double-check the API user email, password, and access token are correct and have not expired.
  • Permissions errors: Ensure the API-only administrator has the "APIIntegration" permission and that the token allows all endpoints.
  • Network restrictions: Mosyle API tokens set to IP-restricted access will fail; make sure public access is selected.
  • Sync status: In Asset Management, review the Integration log for detailed error messages if the nightly sync fails.
Was this article helpful?