Skip to main content
This guide walks you through creating an Acronis API client and connecting your Acronis Cyber Protect Cloud instance to MSPortal.ai. Setup is for MSP staff with integration management permission and authorized credentials for the intended Acronis account.

​
Overview

Acronis Cyber Protect Cloud provides unified backup, disaster recovery, and cyber protection for MSPs. By integrating Acronis with MSPortal.ai, you can:
  • Sync backup status and protection data across all your managed clients
  • Monitor backup alerts and notifications in a centralized dashboard
  • Map Acronis tenants to MSPortal companies for organized data tracking
  • Include backup metrics in client reports

​
Prerequisites

Before you begin, ensure you have:
  • Active Acronis Cyber Protect Cloud account with administrative access
  • MSPortal.ai account with integration management permissions
  • Companies already set up in MSPortal (from your PSA integration or manually created)
The Acronis integration maps tenants to existing companies in MSPortal. Import your companies from your PSA integration first, or create them manually before setting up Acronis.

​
Part 1: Generate API Credentials in Acronis

Before connecting to MSPortal.ai, you need to create an API client in Acronis Cyber Protect Cloud. Create it in the Acronis tenant that can access the customer tenants you want to sync. An API client’s access depends on where it was created, so a successful test does not prove it can see every customer. See Acronis’s API client authentication guidance for more detail.
1

Log into Acronis Management Console

Access your Acronis Cyber Protect Cloud management console using your administrator credentials.
2

Navigate to API Clients

Go to Settings > API Clients (this may also appear under Manage your account > API clients depending on your console version).
3

Create a New API Client

Click Create API Client to begin generating your credentials.Enter a descriptive name for the client:
4

Copy Client ID and Client Secret

After creating the API client, the console will display your Client ID and Client Secret.
Copy the Client Secret immediately! It is only displayed once. If you close the dialog without copying it, you will need to create a new API client. Store both values securely for use in MSPortal.ai.
5

Note Your Datacenter URL

Identify your Acronis datacenter URL. This is visible in the address bar of your Acronis portal and varies by region. Common examples include:
Your datacenter URL is the base URL you see when logged into the Acronis management console, without any trailing path segments. For example, if your browser shows https://us5-cloud.acronis.com/mc/dashboard, the datacenter URL is https://us5-cloud.acronis.com.

​
Required Information

Before proceeding to MSPortal, ensure you have the following:

​
Part 2: Connect Acronis in MSPortal

The Acronis connection page has three setup tasks: Connect, Import or match tenants and Review. Select a task in the Setup guide to return to it at any time.

​
Open the connection

1

Navigate to Integrations

In MSPortal.ai, go to Settings > Integrations.
2

Start Setup

Find Acronis Cyber Protect and select Connect. To change an existing connection, open that connection instead.
Acronis supports more than one connection. If you manage several Acronis accounts, add each one as its own connection, and check that you opened the intended one before you change anything.

​
Connect

1

Enter API Credentials

Fill in the following fields:
Blank Acronis Client Secret field and its explanation in MSPortal setup.
Your credentials are stored securely using encrypted vault storage. They are never exposed in logs or API responses.
2

Test the connection

Select Test connection. MSPortal uses your Client ID and Client Secret to authenticate with the Acronis API and read your root tenant. When the test passes, Connection verified appears with your root tenant name.If the connection fails:
  • Verify you selected the correct datacenter from the dropdown (or entered the correct custom URL)
  • Check that the Client ID and Client Secret are copied exactly, without extra spaces
  • Ensure the API client has not been revoked or deleted in Acronis
  • Confirm your Acronis account has administrative access
3

Save and continue

Once the test passes, select Save and continue to save the connection. MSPortal also requests the first tenant sync in the background. The connection can be saved even if that first sync request fails, so check the tenant list before assuming tenants are available.
Test connection does not save anything. If you change a field after testing, test again before you save.

​
Import or match tenants

Map Acronis tenants (your customers) to MSPortal companies. This determines which company each tenant’s backup data appears under.
1

Load tenants

Open Import or match tenants. If no tenants appear, select Sync tenants and wait for the background sync. The first sync can take a few minutes depending on the number of tenants.
2

Review suggestions

Use Suggested to review proposed matches. Each suggestion shows its confidence. Select Accept on a row to save that match, or use the Accept strong matches button to accept every pair with 90% confidence or more. Untick any pair you want to review yourself.
3

Match the rest

Use Import to find tenants without a match. Select Choose company… to pick an existing MSPortal company, or select Import on the row to create the company from the tenant and match it. Import companies imports several tenants at once; existing companies with the same name are matched instead of duplicated. Check for an existing company first to avoid duplicates.
4

Check saved matches

Use Matched to review saved links. To unlink a tenant, select Change and choose Remove match; it takes effect immediately. Use Ignore for tenants you never want to map.
Matches save as soon as you apply them; wait for the confirmation before you rely on a link. Matching does not create an Acronis customer or start a backup job.
Only data from mapped tenants syncs to MSPortal. You can return to add more mappings at any time.

​
Review

Open Review and select Finish setup once the required tasks are done. Finishing setup does not mean backup data has loaded; data for mapped tenants arrives over the next sync cycles.

​
What Gets Synced

The Acronis integration syncs the following data types to MSPortal:

​
Tenants

Customer and organization data from your Acronis environment, including:
  • Tenant name and identifier
  • Tenant hierarchy and relationships
  • Used for mapping to MSPortal companies

​
Resources

Protected machine and backup resource data:
  • Machine names and identifiers
  • Protection plan assignments
  • Backup agent status
  • Associated tenant information

​
Alerts

Backup and protection alert data:
  • Alert type and severity
  • Affected resource details
  • Alert status and timestamps
  • Protection status notifications

​
Synchronization Schedule

After initial setup, data syncs automatically:
You can request a sync at any time from the Acronis connection page with Run sync. Choose All data or a single data type.

​
Managing Your Integration

After setup, manage the integration from its connection page:

​
Checking Your Credentials

After the integration is created, the credentials are shown read-only. You can test them again, but you cannot change them here.
1

Open the connection

Go to Settings > Integrations and open the Acronis Cyber Protect connection.
2

Retest the Connection

Open Connect and select Test connection. The stored secret is used for the test.
A successful retest does not save a new secret. To use a different API client, disconnect and connect again, which removes the connection’s matches and synced data. To keep them, contact support@msportal.ai before you delete the old API client in Acronis.

​
Adding More Tenant Mappings

As you onboard new clients in Acronis:
1

Open the connection

Go to Settings > Integrations and open the Acronis Cyber Protect connection.
2

Open the tenant task

Select Import or match tenants in the Setup guide.
3

Sync New Tenants

Use Run sync to fetch any new tenants from Acronis.
4

Map New Tenants

Accept suggestions or choose companies manually to connect new tenants to MSPortal companies.

​
Troubleshooting

Causes:
  • Incorrect Datacenter selection, Client ID, or Client Secret
  • API client has been revoked or deleted in Acronis
  • Insufficient account permissions
Solutions:
  1. Verify you selected the correct datacenter from the dropdown, or entered the correct custom URL. The datacenter must belong to the Client ID.
  2. Confirm the Client ID and Client Secret are copied exactly, without extra spaces or missing characters
  3. Log into Acronis and verify the API client still exists under Settings > API Clients
  4. Ensure your Acronis account has administrative privileges
  5. If credentials are lost, create a new API client in Acronis and contact support@msportal.ai to move the integration to it
Causes:
  • Initial sync still in progress
  • API client lacks sufficient permissions
Solutions:
  1. Select Sync tenants or use Run sync, and wait a few minutes for the background sync to complete
  2. Verify that your Acronis API client can access the tenant. Creating companies in MSPortal will not fix provider visibility.
  3. Confirm that your Acronis environment has sub-tenants configured (if you only have a root tenant, there may be nothing to map)
Causes:
  • Tenants are not mapped to MSPortal companies
  • Sync has not completed yet
  • Credentials have expired or been revoked
Solutions:
  1. Ensure at least one tenant is mapped to a company. Only data from mapped tenants syncs
  2. Wait for the current sync to complete before you request another, then check again
  3. Open Connect on the Acronis connection page and select Test connection to confirm the stored credentials still work
Causes:
  • The affected tenant is not mapped to a company
  • Sync for that data type has not run yet
Solutions:
  1. Verify the tenant is matched in Import or match tenants
  2. Use Run sync on the Acronis connection page to request a fresh sync
Review the saved match for the correct connection in Import or match tenants before you change it. Removing a saved match takes effect immediately.
Causes:
  • Selected the wrong datacenter from the dropdown, or entered an incorrect custom URL
Solutions:
  1. Log into your Acronis management console and check the URL in your browser address bar
  2. For a new connection, select the matching datacenter from the dropdown, or use Custom URL and enter the base domain only (e.g., https://us5-cloud.acronis.com), not a full page path
  3. Test the connection again after updating. The datacenter of a saved connection cannot be changed, so disconnect and connect again if it is wrong.

​
Frequently asked questions

No. For a new connection, wait for a successful test, then choose Save and continue. That action saves the connection; synchronization is separate.
An existing integration can open with its saved verified state. Use Test connection when you need a current connection check, then inspect the result.
Suggestions wait for review. Accepting a suggestion saves that match. Importing a tenant as a company also saves the new company and its match, so check for an existing company first.
Finish setup records that setup is complete; matches save separately. Check the correct connection, saved tenant matches, provider access and the sync result. A setup-success message does not mean backup data has finished loading.
No. Removing a saved match takes effect immediately. Verify the company and the Acronis tenant before you remove it.

​
Best Practices

Map Tenants First

Always map your Acronis tenants to companies before expecting data to appear. Only mapped tenant data syncs to MSPortal.

Accept Strong Matches

Start with Accept strong matches, then review the remaining suggestions and unmatched tenants. It saves significant time with large tenant lists.

Secure Your Credentials

Store your Client ID and Client Secret securely. If you suspect they have been compromised, delete the API client in Acronis and create a new one.

Monitor Alerts Regularly

Check backup alerts in MSPortal regularly to stay on top of failed backups and protection issues across your client base.

​
Security and Privacy

  • Credential Storage: Your Client ID and Client Secret are encrypted using vault storage and never exposed in logs or responses
  • Data Isolation: All synced data is tenant-isolated and only visible to your organization
  • Read-Only Access: MSPortal only reads data from Acronis; it does not modify your Acronis configuration or protection plans
  • Token Management: Authentication tokens are automatically refreshed, so you do not need to manage token expiration manually

​
Next Steps

After setting up the Acronis integration:

View Backup Data

Monitor backup status and protection across your client base

Build Reports

Include backup metrics and alert summaries in client reports

Import Companies

Set up companies if you have not done so already

Integration Troubleshooting

Answers to common integration questions

​
Need Help?

For assistance with the Acronis integration, contact support@msportal.ai.