npm package: @mspcopilot/n8n-nodes-mspcopilot
Description: MSP Copilot Nodes for n8n
Author: Dan Buhler
Latest version: 0.1.2

# n8n-nodes-mspcopilot

This is an n8n community node. It lets you use MSP Copilot Link in your n8n workflows.

MSP Copilot Link provides a unified company database across all your MSP integrations. Instead of juggling different company IDs, domains, and names across ConnectWise PSA, IT Glue, Microsoft Partner Center, and other platforms, Link gives you a single source of truth.

More info at [https://mspcopilot.io/n8n-nodes/mspcopilot-link](https://mspcopilot.io/n8n-nodes/mspcopilot-link)

Built by [Dan Buhler (j0dan)](https://www.reddit.com/user/j0dan/) for the MSP community. Shoutout to [r/msp](https://www.reddit.com/r/msp/).

[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

## Supported Integrations

**Active:**
- ConnectWise PSA
- ConnectWise Automate
- IT Glue
- Pax8
- Microsoft 365
- CIPP
- CyberHoot
- Huntress
- QuickBooks Online

**Coming Soon:**
- Hudu
- Halo PSA

## Operations

### Get All Mappings
Retrieve all companies with their mappings across integrations. This is useful for building company directories, synchronization workflows, or data exports.

**Features:**
- Filter by integration (only return companies mapped to a specific integration)
- Filter by tags (filter by integration-specific tags, multiple tags use AND logic)
- Optional minimal output mode (only essential fields: uuid, domains, links)
- Include metadata option (returns integration-specific data like agent counts, user counts)

### Lookup
Perform single or bulk company lookups. This is the most powerful operation - feed it data from any integration and it will enrich it with canonical company information and cross-integration mappings.

**Lookup Types:**
- **Shortcode / UUID** - Your internal company identifier
- **Integration ID** - ConnectWise PSA ID, IT Glue ID, Microsoft Tenant ID, etc. (dynamically loaded from your configured integrations)

**Features:**
- Bulk lookup support (processes all incoming items in a single API call)
- Add to incoming data mode (enriches your existing data with `__link` field)
- Only return matches option (filters out non-matches)
- Filter by tags (filter results by integration-specific tags, multiple tags use AND logic)
- Optional minimal output mode
- Include metadata option (returns integration-specific data like agent counts, user counts)

**Example Use Cases:**
- Enrich Microsoft 365 audit logs with information from IT Glue, then create a ticket in your PSA
- Synchronize data between Pax8 and IT Glue
- Cross-reference data between multiple MSP platforms

### Manual Sync
Trigger a manual synchronization of one or all integrations. This updates the Link database with the latest data from your configured integrations.

**Features:**
- Sync a specific integration or all configured integrations
- Wait for completion option (enabled by default, returns when sync finishes)
- Note: Manual sync should only be used when necessary (e.g., after initial setup). Frequent syncs may impact API rate limits.

## Credentials

This node uses API key authentication.

1. Sign up for MSP Copilot Link at [https://link.mspcopilot.io](https://link.mspcopilot.io)
2. Navigate to API Keys
3. Generate a new API key
4. Add the credential in n8n using your API key

## Example Workflows

### Enrich incoming webhook data
Use the Lookup operation with "Add to incoming data" enabled. The node will add a `__link` field to each item containing all cross-integration mappings.

```
Webhook → MSP Copilot Link (Lookup) → Process enriched data
```

### Build a company directory
Use "Get All Mappings" to retrieve all companies, then use downstream nodes to create reports, update spreadsheets, or sync to other systems.

```
Schedule → MSP Copilot Link (Get All Mappings) → Google Sheets
```

### Cross-platform automation
Lookup companies by one integration's ID and get IDs for all other platforms:

```
ConnectWise Trigger → MSP Copilot Link (Lookup: ConnectWise PSA) → IT Glue Action
```

## Functionality

- **Bulk operations**: Lookup processes all incoming items in a single API call for better performance
- **Flexible output**: Choose minimal output for cleaner data or full output for complete information
- **Smart matching**: Lookup automatically matches results back to incoming items using keyed responses

For more example workflows, visit [https://mspcopilot.io/n8n-workflows](https://mspcopilot.io/n8n-workflows)

## Resources

- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
- [MSP Copilot](https://mspcopilot.io)
- [Installation guide for n8n community nodes](https://docs.n8n.io/integrations/community-nodes/installation/)

## More MSP Integrations

Check out the growing collection of MSP-focused n8n nodes:
- [MSP Copilot Link](https://mspcopilot.io/n8n-nodes/mspcopilot-link) - Unified company database across all your integrations
- [ConnectWise PSA](https://mspcopilot.io/n8n-nodes/connectwise-psa) - Better-than-first-party ConnectWise integration
- [UniFi Site Manager](https://www.npmjs.com/package/@mspcopilot/n8n-nodes-unifi-sitemanager) - Manage UniFi devices across sites
- [Microsoft Partner GDAP](https://mspcopilot.io/n8n-nodes/microsoft-partner-gdap) - Microsoft Partner Center and GDAP management

### Workflow Examples

More examples at [https://mspcopilot.io/n8n-workflows](https://mspcopilot.io/n8n-workflows)