Skip to main content
This guide walks you through connecting your Acronis Cyber Protect Cloud instance to MSPortal.ai using our streamlined 2-step setup wizard.

​
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.
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: MSPortal Setup Wizard

MSPortal.ai provides a guided 2-step wizard to connect and configure your Acronis integration.

​
Starting the Wizard

1

Navigate to Integrations

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

Start Setup

Find the Acronis Cyber Protect integration card and click Configure to launch the setup wizard.

​
Step 1: Connect

Enter your Acronis API credentials to establish the connection.
1

Enter API Credentials

Fill in the following fields:
Your credentials are stored securely using encrypted vault storage. They are never exposed in logs or API responses.
2

Test Connection

Click Test Connection to verify your credentials. MSPortal will use your Client ID and Client Secret to authenticate with the Acronis API and retrieve your root tenant information. You will see a green “Connection successful” message when the test passes.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

Create Integration

Once the connection test passes, click Create Integration to save your credentials and proceed to tenant mapping.

​
Step 2: Map Tenants

Map Acronis tenants (your customers/clients) to MSPortal companies. This determines which backup data syncs to which company.
1

Sync Tenants

If no tenants appear, click Sync to fetch tenants from your Acronis account. The initial sync may take a few minutes depending on the number of tenants in your environment.
The sync runs in the background. If tenants do not appear immediately, wait a few minutes and check again.
2

Use Quick Match

Click Quick Match to automatically match Acronis tenants to MSPortal companies based on name similarity. This saves significant time when you have many tenants with matching names.
Quick Match uses intelligent name matching to find likely matches. Review the results and make manual adjustments for any incorrect or missing matches.
3

Manual Mapping

For tenants that were not automatically matched or need adjustment:
  1. Find the tenant in the list
  2. Click the Select company dropdown in the “Mapped To” column
  3. Search for and select the correct MSPortal company
To remove a mapping, click the X button next to the company badge.
4

Filter Tenants

Click the summary cards above the list to filter the view:
  • Total Items - Show all synced tenants
  • Mapped - Show only tenants linked to companies
  • Unmapped - Show tenants that still need mapping
5

Complete Setup

Once you have mapped your tenants, click Complete Setup to finish the wizard.
Only data from mapped tenants will sync to MSPortal. You can return to add more mappings at any time.

​
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 trigger a manual sync at any time from Settings > Integrations by clicking Resync on the Acronis card.

​
Managing Your Integration

After setup, manage your integration from Settings > Integrations:

​
Updating Your Credentials

If you need to update your Acronis API credentials (for example, after rotating your Client Secret):
1

Open Integration Settings

Go to Settings > Integrations and click Configure on the Acronis card.
2

Enter New Credentials

On the Connect step, select your updated Datacenter, Client ID, and/or Client Secret.
3

Test Connection

Click Test Connection to verify the new credentials work correctly.

​
Adding More Tenant Mappings

As you onboard new clients in Acronis:
1

Open Integration Settings

Go to Settings > Integrations and click Configure on the Acronis card.
2

Navigate to Map Step

Click on Step 2 (Map Tenants) in the wizard stepper.
3

Sync New Tenants

Click Sync to fetch any new tenants from Acronis.
4

Map New Tenants

Use Quick Match or manual mapping 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
  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 update the integration
Causes:
  • Initial sync still in progress
  • API client lacks sufficient permissions
Solutions:
  1. Click Sync and wait a few minutes for the background sync to complete
  2. Verify that your Acronis account has access to view tenant information
  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 will sync
  2. Wait for the sync to complete, then check again
  3. Return to the integration settings and test the connection to verify credentials are still valid
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 mapped in the integration wizard
  2. Click Resync on the Acronis card to trigger a fresh sync
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. 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

​
Best Practices

Map Tenants First

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

Use Quick Match

Start with Quick Match for tenant mapping, then manually adjust any incorrect matches. 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

Other Integrations

Explore additional integration options

​
Need Help?

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