n8n-nodes-druva-msp

This package provides n8n nodes to integrate with Druva MSP APIs, allowing Managed Service Providers to automate various operations related to customer management, tenant provisioning, reporting, and more.

IMPORTANT: When updating between versions, make sure to restart your n8n instance after the update. UI changes and new features are only picked up after a restart.

Features

The Druva MSP integration provides access to the following resources:

• Admin Management

  • List, create, retrieve, update, and delete administrators
  • Filter by specific admin IDs

• Customer Management

  • Create and manage MSP customers (including custom attributes at creation time)
  • Update customer details including contact information and custom attributes
  • Generate customer-specific access tokens for API operations
  • List and filter customers; includes computed isDruvaProvisioned field

• Alert Summary

  • Aggregate alerts from Endpoints, Enterprise Workloads, Microsoft 365, and Google Workspace into a single normalised feed
  • All alerts normalised to a unified schema: workload, entity, alertDetails, severity, timestamp, isActive
  • Parallel fetch across all selected workloads; sorted by timestamp descending
  • Filter by workload, date range, and specific customers; supports return-all or limit

• Backup Health Summary

  • Aggregate endpoint last-backup-status into per-customer health summaries
  • Reports device counts by status (completed / failed / not-started / in-progress), success rate, and failure rate
  • Configurable criticalThresholdPercent determines healthy / warning / critical classification
  • Results sorted critical → warning → healthy; filter output by returnLevel (all / unhealthy only / critical only)

• Consumption Billing Analyzer

  • Process consumption data with custom calculation methods for billing purposes
  • Apply configurable rounding and byte-value conversion
  • Returns a fully flattened data structure for easy processing in n8n workflows
  • Filter by specific customers, date ranges, and service plans
  • Optional auto-generated deterministic key for database storage
  • Compare consumption against quota (analyzeConsumptionWithQuota): fetches consumption and quota in parallel, joins by customer/product/feature, and appends quotaAllocated, isOverQuota, overageAmount, and headroomPercent to each row; optional showOnlyOverages filter

• Event Monitoring

  • Access MSP-level and customer-level events with client-side date filtering

• Service Plan Management

  • View and filter available service plans (by status, name, editions, and features)

• Storage Region

  • Retrieve available storage regions grouped by product (GET /msp/v2/storage-regions)
  • Response flattened to per-region items with productID, name, and storageProvider

• Task Management

  • Track task status and progress

• Tenant Management

  • Create, retrieve, and update tenants
  • Suspend and unsuspend tenant operations
  • Filter tenants by product; includes computed isDruvaProvisioned field
  • Feature entitlement data included by default

• Comprehensive Reporting

  • Usage Reports — Global Usage, Tenant Consumption/Quota, MSP Commit and Balance, Customer and License (Daily/Monthly), Chargeback Tenant Consumption (Daily/Monthly); filterable by customer, product, edition, usage description, MSP Global ID, and MSP Name
  • Cyber Resilience Reports — Rollback Actions, Data Protection Risk
  • Endpoint Reports — Users, User Rollout, User Provisioning, License Usage, Last Backup Status, Alerts, Storage Statistics, Storage Alert, Cloud Cache Statistics, Restore Activity, Preserved Users Datasources
  • Enterprise Workloads Reports — M365 and Google Workspace operations: Alerts, Groups/Teams/SharePoint/Shared Drive Discovery, License Usage, Preserved Users Datasources, Storage Consumption, User Count and Status, User Last Backup Status, User Provisioning, User Restore/Workload Activity; plus M365 Backup Activity (Groups, Public Folder, SharePoint, Teams)

Task polling (workflow-level)

The Task resource exposes Get Task to check task status. n8n Cloud restricts timers inside community nodes, so waiting/polling must be done at the workflow level:

Pattern

1. Get Task – fetch the task by taskId
2. IF – check status === 4 (Finished)
   • If yes: continue
   • If no: Wait 5–10 seconds
3. Loop back to step 1 until finished

Status values

• 1: Queued
• 2: Running
• 3: Failed
• 4: Finished

Authentication

This node requires Druva MSP API credentials to authenticate:

1. Sign in to your Druva MSP portal
2. Navigate to Settings > API Credentials
3. Create new API credentials (Client ID and Secret Key)
4. Use these credentials in the Druva MSP API credentials in n8n

License

This project is licensed under the MIT License.

Support

If you find this node helpful and would like to support its development: