Skip to main content

Migrate from IT Glue with the Lex Migration App

Move IT Glue documentation into Lexful using the Lex migration app for Windows.

This article walks through how to migrate your IT Glue data into Lexful using the Lex migration app on a Windows machine.


TL;DR: Download the Lexful Migration app, enter your IT Glue and Lexful credentials, load your IT Glue export, and run the migration. An optional second step captures related item links between assets.


Prerequisites

Before starting, make sure you have the following:

  • API access enabled on your IT Glue account

  • A Windows computer or VM that can be dedicated to this task

šŸ“ For large datasets, the migration may run across several days. IT Glue's API is limited to 9,500 calls per day. The app manages this automatically and resumes after the quota resets.


Overview

The migration runs in five stages, all handled inside the app:

  • Credentials - Enter your IT Glue and Lexful API keys

  • File - Load your IT Glue export

  • Orgs - Select which organizations (or all) to import into Lexful

  • Migrate - Run the main data migration

  • Related - Capture related item links between assets


Step 1 - Export Your IT Glue Data

Generate or locate your ITGlue full export zip by following the instructions in the following IT Glue help article:
​
​https://help.itglue.kaseya.com/help/Content/1-admin/import-and-export/exporting-and-backing-up-account-data.html

  • Note: To bring passwords into Lexful be sure to check the "Include Passwords" box when you export (this is not mentioned in the help instructions)

Export encryption is optional. Both password-protected and unprotected ZIP exports are supported. Leave File Password blank for an unprotected export. For an encrypted export, enter the password you set in IT Glue; the app validates it before continuing.


Step 2 - Download and Install the App

Download and extract the Lex Migration app: lex-migration-0.3.6-setup.exe.zip

Run the installer and launch Lex Migration once installation is complete.


Step 3 - Enter Credentials

On the Credentials screen, enter the following:

  • IT Glue API Key - Generate an IT Glue API Key by following this IT Glue help file: https://help.itglue.kaseya.com/help/Content/1-admin/it-glue-api/getting-started-with-the-it-glue-api.html

  • Generate a Lexful API key in Platform > API keys. Copy Account ID from that page, and Key ID and Secret from the key dialog. In the migration app, these correspond to Lexful Account ID, Lexful API Key ID (or Lexful Key ID), and Lexful API Secret (or Lexful Secret). ā€œAPI IDā€ in older instructions means Key ID, not the Secret. Copy the Secret when you create the key; it cannot be viewed again after closing the dialog.

Check Remember credentials to avoid re-entering these on future sessions. Click Next when done.

šŸ’” Credentials are stored encrypted by the OS and never transmitted outside of the API calls themselves.


Step 4 - Select the Export File

On the File screen, you will see confirmation that both IT Glue and Lexful are connected.

  • Click Browse and select the IT Glue export zip file

  • Enter the File Password you set during export (if you chose to do so) - the app validates it locally and will confirm it is correct before proceeding

  • Check Exclude archived items if you do not want to migrate archived records into Lexful

Click Next to continue.


Step 5 - Choose organizations

On Organizations, choose All organizations or Select specific. To test first, select one organization. Click Next when ready.

Testing one organization before a full migration

Select one organization first, then review its imported records in Lexful before expanding the migration.

A repeat import is not a fresh copy by definition: the import pipeline uses source IDs and saved mappings to match existing records where available. That does not guarantee that every record will be deduplicated, and existing records may be updated. Before importing the test organization again or switching to all organizations, contact Lexful Support to confirm the plan for your source and destination account.

Do not run overlapping migrations into the same Lexful account. Keep your source export until you have reviewed the results.


Step 6 - Run the Migration

The app will work through the following stages automatically:

  • Extracting organizations, locations, and domains

  • Extracting configurations, contacts, and flexible asset types and records

  • Extracting passwords

  • Zipping and uploading the JSON extract

  • Uploading the CSV export

Progress is shown in real time. You can track the current upload stage and overall progress from the Migration Progress screen.

šŸ’” Notice the API call counter in the top right corner. IT Glue's API is limited to 9,500 calls per day. The app manages this automatically and resumes after the quota timer resets. IT Glue's API quota resets at midnight UTC.

šŸ’” You can close the window at any time by clicking "Minimize to Tray" in the bottom right corner. The migration continues running in the background via the system tray and can be paused or cancelled from there.

šŸ’” You will get an email when the upload process starts, and another email when it completes. If it fails due to an error, you will be emailed the report and can contact support using the "Support" tab in the Lexful UI.

If you cannot access your Lexful tenant, you can use the buttons in the app for Email support, Copy diagnostics, or Show logs at the bottom of the screen to contact Lexful support.


Step 7 - Run the Related Items Migration (optional)

Once the main migration completes, the app will prompt you to extract related items - the links between assets in IT Glue.

Select the asset types you want to capture relationships for:

  • Configurations

  • Flexible assets

  • Passwords

  • Contacts

  • Locations

Choose a Pace for the extraction:

  • Crawl (2/s) - Slowest, lowest API usage

  • Walk (5/s) - Balanced, recommended for most accounts

  • Run (9/s) - Fastest, higher API usage

Click Start related items extraction to begin.

šŸ“ Related items extraction makes one API call per record. For large tenants this can take 1-3 days. The app runs in the background and resumes automatically after IT Glue's daily API quota resets.

When complete, the Related screen will show a full breakdown of how many records were processed per asset type.


Migration History

The left panel in the app shows a log of all past migrations, including upload status, file names, data size, and timestamps. Use this to confirm that both the main migration and related items export completed successfully.


āš ļø Do not run multiple migrations simultaneously against the same Lexful account. If you need to restart a migration, contact support using the "Support" tab in the Lexful UI.


Did this answer your question?