Skip to main content

Prerequisites

  • An N-central account with permission to create an API-only user and generate an API token
  • The HTTPS URL for your N-central server
  • MSPortal.ai integration management permission
  • Companies in MSPortal to map to N-central customers

Create an N-central API Token

1

Create an API-only user

In N-central, create a dedicated API-only user for MSPortal. Disable MFA for this API user and use a non-expiring password so scheduled synchronization can continue. Give the user access to the customers you want to sync.
2

Open API Access

Go to Administration > User Management > Users, open the API user, and select API Access.
3

Generate the token

Click Generate JSON Web Token and copy the token. Store it securely until you enter it in MSPortal.

Connect N-central in MSPortal

Go to Settings > Integrations, open the Directory tab, find N-able N-central, and select Connect. To work on an existing connection, open it from the Active tab with Open. The connection page lists its tasks in the Setup guide. Under Setup you will find Connect, Choose data, Import or match companies, Import devices, and Review. Under Manage you will find Overview and Sync activity. Select a task to open it.
1

Enter the connection details

In Connect, enter your Server URL, such as https://ncentral.example.com, and the API Token (JWT) generated in N-central. Credentials are stored in the vault and never shown again.
2

Test the connection

Select Test connection. Resolve any authentication or server URL error before continuing.
3

Save the connection

After the test succeeds, select Save and continue. MSPortal stores the token securely. A successful test alone does not save the connection.

Choose Data

N-central syncs all of its customer and device data, so Choose data has no dataset switches. The task is done once the first sync has run.

Match Customers and Import Devices

1

Wait for customers to load

Open Import or match companies. The workspace is titled Import or match N-able N-central customers and lists your N-central customers once they have synced. If the list is empty, select Sync customers and wait for them to arrive.
2

Review suggested matches

Open Suggested to review proposed matches and their confidence. Select Accept to save a match, or Change to choose a different company. 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.
3

Match the remaining customers

In Import, the view the workspace opens on, choose the MSPortal company each remaining customer belongs to. If the company does not exist yet, select Import company, after checking for duplicates. Select Ignore for customers you don’t want to sync; you can Restore them later from Ignored.
4

Check your matches

Review Matched. Accepting or choosing a company saves the match immediately. Remove match also takes effect immediately. Devices for newly matched customers arrive with the next device sync.
5

Match device types

Open Import devices. Under Match device types, choose the MSPortal device type for each N-central device category. Use Match all suggested or Match the rest with AI to speed this up. Turn on Auto-import for types you always want imported, and ignore types you never want.
6

Import devices

Under Staged devices, select Import all matched, or select devices and use Import N selected. Only devices belonging to matched customers can be associated with the correct MSPortal company. Every change saves immediately.
7

Finish setup

Open Review and select Finish setup once the required tasks are done. Finishing setup does not mean every background sync or import has finished. Check Import devices and the resulting Devices records.
See Import Devices for more on device type matching and imports.

Sync Schedule

N-central connections do not offer Run sync. To refresh the customer list sooner, select Sync customers when Import or match companies is empty. Use Sync activity to check recent results. A scheduled time does not guarantee a successful run.

Managing the Connection

Open the N-central connection from the Active tab in Settings > Integrations. Select any task in the Setup guide to return to it. Use Overview for the connection’s status and Sync activity to inspect synchronization and errors. To replace the server URL or token:
1

Open Connect

Open the N-central connection and select Connect in the Setup guide.
2

Enter the replacement values

Update the Server URL if needed, and enter the replacement token in API Token (JWT). Leave the masked token unchanged to keep the stored one. If you change the server URL, enter the token again; a stored token is only sent to the URL it was saved with.
3

Test the connection

Select Test connection and wait for Connection verified.
4

Save changes

Select Save changes to store the new server URL or token. Testing alone does not save replacements.
Return to Import devices at any time to review newly discovered devices or adjust device type matches. To rename the connection, use Rename under More actions in the connection header. Disconnect…, also under More actions, removes the stored credentials, the matches between N-central customers and companies, and synced data after you confirm. It does not revoke the token in N-central.

Troubleshooting

Frequently Asked Questions

No. For a new connection, test successfully and then select Save and continue. For an existing connection, select Save changes to store replacement values.
No. Suggestions wait for your review. Accepting a suggestion saves its match immediately; removing a saved match also takes effect immediately.
No. Device sync, saved matches and device imports have separate results. Check Import devices and the resulting inventory.
No. Provider setup is an MSP settings task. Company access to resulting data depends on portal permissions and company scope.
Customer sync, company matching, device sync and device import are separate stages. Check the saved customer match and the device sync result in Sync activity before importing.

Import Devices

Review the shared device import workflow

Integrations Overview

Manage all MSPortal integrations