The Acronis integration is currently in Beta. Core functionality is complete and available for all users. You will see a “Beta” badge on the Acronis card in the Integrations page. If you encounter any issues, contact support@msportal.ai.
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.Log into Acronis Management Console
Access your Acronis Cyber Protect Cloud management console using your administrator credentials.
Navigate to API Clients
Go to Settings > API Clients (this may also appear under Manage your account > API clients depending on your console version).
Create a New API Client
Click Create API Client to begin generating your credentials.Enter a descriptive name for the client:
| Field | Recommended Value |
|---|---|
| Name | MSPortal Integration |
Copy Client ID and Client Secret
After creating the API client, the console will display your Client ID and Client Secret.
Required Information
Before proceeding to MSPortal, ensure you have the following:| Information | Description |
|---|---|
| Datacenter | Your Acronis datacenter region (MSPortal provides a dropdown of known datacenters, with a custom URL option) |
| Client ID | The client identifier generated when creating the API client |
| Client Secret | The secret generated when creating the API client |
Part 2: MSPortal Setup Wizard
MSPortal.ai provides a guided 2-step wizard to connect and configure your Acronis integration.Starting the Wizard
Step 1: Connect
Enter your Acronis API credentials to establish the connection.Enter API Credentials
Fill in the following fields:
| Field | Description |
|---|---|
| Datacenter | Select your Acronis datacenter from the dropdown. If your datacenter is not listed, choose Custom URL and enter the base URL manually. |
| Client ID | The client identifier from your Acronis API client |
| Client Secret | The secret from your Acronis API client |
Your credentials are stored securely using encrypted vault storage. They are never exposed in logs or API responses.
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
Step 2: Map Tenants
Map Acronis tenants (your customers/clients) to MSPortal companies. This determines which backup data syncs to which company.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.
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.
Manual Mapping
For tenants that were not automatically matched or need adjustment:
- Find the tenant in the list
- Click the Select company dropdown in the “Mapped To” column
- Search for and select the correct MSPortal company
Filter Tenants
Use the filter dropdown to view:
- All Tenants - Show all synced tenants
- Mapped Only - Show only tenants linked to companies
- Unmapped Only - Show tenants that still need mapping
What Gets Synced
The Acronis integration syncs the following data types to MSPortal:| Data Type | Sync Direction | Description |
|---|---|---|
| Tenants | Acronis -> MSPortal | Tenant and customer information used for company mapping |
| Resources | Acronis -> MSPortal | Protected machines, backup agents, and managed resources |
| Alerts | Acronis -> MSPortal | Backup alerts, status notifications, and protection warnings |
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:| Data Type | Sync Frequency |
|---|---|
| Tenants | Every 4 hours |
| Resources | Every 30 minutes (at :10 and :40) |
| Alerts | Every 30 minutes (at :05 and :35) |
You can trigger a manual sync at any time from Settings > Integrations by clicking Configure on the Acronis card.
Managing Your Integration
After setup, manage your integration from Settings > Integrations:| Action | Description |
|---|---|
| Configure | Re-open the setup wizard to modify settings or update tenant mappings |
| Sync Tenants | Refresh the list of tenants from Acronis |
| Sync Resources | Fetch the latest protected machines and backup agents |
| Sync Alerts | Pull the latest backup alerts and status notifications |
| Delete | Remove the integration and all stored credentials |
Updating Your Credentials
If you need to update your Acronis API credentials (for example, after rotating your Client Secret):Enter New Credentials
On the Connect step, select your updated Datacenter, Client ID, and/or Client Secret.
Adding More Tenant Mappings
As you onboard new clients in Acronis:Troubleshooting
Connection test fails
Connection test fails
Causes:
- Incorrect Datacenter selection, Client ID, or Client Secret
- API client has been revoked or deleted in Acronis
- Insufficient account permissions
- Verify you selected the correct datacenter from the dropdown, or entered the correct custom URL
- Confirm the Client ID and Client Secret are copied exactly, without extra spaces or missing characters
- Log into Acronis and verify the API client still exists under Settings > API Clients
- Ensure your Acronis account has administrative privileges
- If credentials are lost, create a new API client in Acronis and update the integration
No tenants appear in mapping step
No tenants appear in mapping step
Causes:
- Initial sync still in progress
- API client lacks sufficient permissions
- Click Sync and wait a few minutes for the background sync to complete
- Verify that your Acronis account has access to view tenant information
- Confirm that your Acronis environment has sub-tenants configured (if you only have a root tenant, there may be nothing to map)
Data not syncing after setup
Data not syncing after setup
Causes:
- Tenants are not mapped to MSPortal companies
- Sync has not completed yet
- Credentials have expired or been revoked
- Ensure at least one tenant is mapped to a company — only data from mapped tenants will sync
- Wait for the sync to complete, then check again
- Return to the integration settings and test the connection to verify credentials are still valid
Missing alerts or resources
Missing alerts or resources
Causes:
- The affected tenant is not mapped to a company
- Sync for that data type has not run yet
- Verify the tenant is mapped in the integration wizard
- Trigger a manual sync for the specific data type (Sync Resources or Sync Alerts) from the integration management page
Wrong datacenter selected
Wrong datacenter selected
Causes:
- Selected the wrong datacenter from the dropdown, or entered an incorrect custom URL
- Log into your Acronis management console and check the URL in your browser address bar
- 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 - 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