Skip to main content
ConnectWise Asio (formerly ConnectWise RMM) is a remote monitoring and management platform. This guide is for MSP staff who connect Asio so its companies, devices, hypervisors and network devices appear in MSPortal. On the Asio connection page, the Setup guide lists Connect, Choose data, Import or match companies, Locations (optional), Import devices and Review.

Before you start

  • You are MSP staff with permission to manage integrations. Company users cannot set this up.
  • You have admin access to ConnectWise Asio.
  • Your companies already exist in MSPortal, usually from your PSA integration. Asio companies are mapped to those existing companies.
  • ConnectWise PSA keys do not work here. Asio uses its own API Client ID and Client Secret.
The first sync can take hours, or even days, for a large account. Companies appear on Import or match companies as they sync, and devices appear in staging as the sync progresses.

Create API credentials in Asio

1

Open API Access

Sign in to ConnectWise Asio as an admin and go to Integrations > API Access.
2

Add an API key

Select Generate API Access (or + Add if you already have keys) and enter MSPortal as the API Key Name.
3

Choose the scopes

Grant these scopes.Platform - Devices Write lets MSPortal save a device’s friendly name back to Asio. Everything else works without it, but renaming a device shows “The RMM didn’t accept the new friendly name”.
4

Save and copy the credentials

Select Save. Copy the Client ID and Client Secret now. Asio does not show them again after you close the dialog.

Connect Asio to MSPortal

1

Start the setup

In MSPortal, go to Settings > Integrations, choose Directory, find ConnectWise Asio and select Connect. To change an existing connection, open it from your active integrations instead.
2

Enter the connection details

On Connect, fill in these fields.
3

Test the connection

Select Test connection. If it fails, check the environment, the Client ID prefix, the secret and the scopes.
4

Save the connection

Select Save and continue. This saves the connection and starts discovery. A successful test alone does not save the connection. The secret is stored in encrypted vault storage.

Choose data

Open Choose data to pick which data to import. The choices are Companies, Locations, Devices, Networks, Tickets and Software. Changes save as you make them. Turning a category off stops future syncs of it. Turning Software off removes that integration’s software inventory, and turning it back on starts a new inventory sync. Devices, networks and software use your existing company mappings, so keep Companies on to discover new companies to map.

Map companies

1

Open Import or match companies

The list shows each Asio company and whether it is matched. Companies appear after discovery has returned them from Asio.
2

Match companies

Accept a suggested match, or choose the MSPortal company on each row. Review N suggested matches opens Accept suggested matches, which lists every suggestion at 70% confidence or more with those at 90% or more already selected. Lower the Auto-select by confidence slider, as far as 70%, to select weaker suggestions too, untick any pair you want to check yourself, then select Apply N Matches. Ignore hides an Asio company that is not a client’s.
3

Check the saved links

Each accepted match saves immediately. Check that the rows show saved links before you continue.
Map Asio companies to companies you already have. Import company creates a new MSPortal company immediately, so check for an existing one first.
Removing a saved link takes effect immediately. Saved matches decide which company receives Asio data.

Map locations (optional)

1

Open Locations

Only locations for matched companies appear. If you do not need location mapping, skip this task.
2

Match locations

Accept a suggestion, choose one of the company’s locations, or create one from the row. Every change saves immediately.
Matching alone does not create missing locations. If no locations appear, check the company match and that discovery has finished.

Import devices

1

Open Import devices

Open Import devices on the connection page. Staged devices and type mappings are on the same page.
2

Match device types

In Match device types, choose the MSPortal device type each Asio type becomes. Turn on Auto-import for types you want imported automatically. Every change saves immediately.
3

Import the devices you want

In Staged devices, select the devices and import them, or use Import all matched. Devices whose company is not matched yet show Match company first.
4

Finish setup

Open Review and select Finish setup once the required tasks are complete.
For selections, type mappings and results, see Import Devices.

Friendly names

Asio’s friendly name for a device syncs to MSPortal on its own. The device name stays the computer’s hostname.
  • In Devices, the Friendly Name column shows it. Filter, sort, search and the CSV download include it.
  • A device’s panel is titled by its friendly name, with the device name beside it.
  • People with manage access to Devices can rename a device: click its Friendly Name in the table, or change Friendly Name on the device’s Edit tab. MSPortal saves the new name to Asio, so it changes there too. See Add and edit device records.
Renaming needs the Platform - Devices Write scope. To add it to an existing connection, edit the MSPortal API key in Integrations > API Access in Asio and give Platform - Devices both Read and Write. The Client ID and Client Secret stay the same, so nothing changes in MSPortal.

Manage an existing connection

  • Update the secret: open Connect, enter the new Client Secret, select Test connection, then Save changes. Leave the masked secret unchanged to keep it. The saved environment and Client ID are locked; to change them, connect a new Asio API client.
  • Check status: use Overview and Sync activity to see the connection status, sync runs and errors.
  • Sync now: select Run sync on the connection page.
  • Disconnect: open More actions and choose Disconnect…. This removes the stored credentials, the company matches and the data synced from Asio. It does not revoke the API key in Asio, so remove that key in Asio yourself.

Troubleshooting

Frequently asked questions

No. After a successful test, select Save and continue for a new connection, or Save changes for an existing one.
No. Device sync and import run separately. Check Import devices and the resulting inventory.
No. Setup is an MSP staff task.
No. Asio is the RMM connection. ConnectWise PSA has its own setup for tickets and company imports.