This document outlines the required ConnectWise configuration steps to enable integration with Support Fusion. Complete these steps in your ConnectWise instance before configuring the connection in Support Fusion.
Prerequisites
- ConnectWise instance administrator access
- Knowledge of ConnectWise security roles and API member management
- Understanding of ConnectWise company and board configuration
Step 1: Create Security Role with Required Permissions
This security role will define the specific permissions needed for Support Fusion to integrate with your ConnectWise instance. The integration requires access to various modules with specific permission levels.
1.1 Create New Security Role
- Navigate to System > Security Roles in ConnectWise
- Click the + button to create a new security role
- Role ID: SupportFusionIntegration
- Click Save to create the role
1.2 Configure Module Permissions
After saving the role, the permissions table will appear. Configure the following permissions for each module:
Companies Module:
- Company Maintenance: Inquire - ALL
- Company/Contact Group Maintenance: Inquire - ALL
- Configurations: Inquire - ALL
- Contacts: Inquire - ALL
- Manage Attachments: Add - ALL, Edit - ALL, Inquire - ALL
- Management: Inquire - ALL
- Notes: Inquire - ALL
- Team Members: Inquire - ALL
- Tracks: Inquire - ALL
Service Desk Module:
- Close Service Tickets: Add - ALL, Edit - ALL, Inquire - ALL
- Merge Tickets: Edit - ALL, Inquire - ALL
- Service Ticket - Dependencies: Add - ALL, Edit - ALL, Inquire - ALL
- Service Tickets: Add - ALL, Edit - ALL, Inquire - ALL
- SLA Dashboard: Inquire - ALL
- Ticket Templates: Inquire - ALL
System Module:
- Table Setup: Inquire - ALL
1.3 Save Security Role
- Review all permission settings to ensure they match the requirements above
- Click Save to create the security role
- Note the Role ID - you'll need this for the API member creation
Step 2: Create API Member Account
API members are special user accounts in ConnectWise designed specifically for third-party integrations. They can only access ConnectWise through the API and cannot log into the web interface.
2.1 Access API Member Management
- Navigate to System > Members in ConnectWise
- Click API Members tab
- Click Add to create a new API member
2.2 Configure API Member Details
Fill in the required API member information:
Basic Information:
- Member ID: SupportFusion (or your preferred identifier)
- Member Name: Support Fusion Integration
- Email Address: Optional - Use a monitored email address if desired (e.g., support.fusion@yourcompany.com)
- Role ID: Select "SupportFusionIntegration" (the role created in Step 1)
System Settings:
- Time Zone: Set to your organisation's time zone
- Level: Select "Corporate (Level 1)" or appropriate level
- Location: Select your default office location
- Business Unit: Select appropriate business unit
Service Defaults:
- Default Board: Select the primary service board where tickets will be managed
- Restrict Board Access: Select the same board to limit access
2.3 Generate API Keys
- After saving the API member, click on the API Keys tab
- Click Generate to create the public and private key pair
- CRITICAL: Copy both keys immediately:
- Public Key: Copy and store securely
- Private Key: Copy and store securely - this will only be displayed once
- The private key cannot be recovered if lost - you'll need to generate new keys
2.4 Record API Credentials
Make note of the following values - you'll need them for Support Fusion configuration:
- Public Key: The generated public key from Step 2.3
- Private Key: The generated private key from Step 2.3
- ConnectWise API URL: Your region-specific API URL (see Step 3)
Step 3: Determine Your ConnectWise API URL
The API URL format depends on your ConnectWise hosting region and instance URL.
3.1 Identify Your Region
Check your ConnectWise login URL to determine the correct API endpoint:
Australia/Asia Pacific:
- If your login URL is:
https://au.myconnectwise.net
- Your API URL is:
api-au.myconnectwise.net
North America:
- If your login URL is:
https://na.myconnectwise.net
- Your API URL is:
api-na.myconnectwise.net
Europe:
- If your login URL is:
https://eu.myconnectwise.net
- Your API URL is:
api-eu.myconnectwise.net
Staging Environment:
- If your login URL is:
https://staging.myconnectwise.net
- Your API URL is:
api-staging.myconnectwise.net
Step 4: Configure Support Fusion Integration
Once you have completed the ConnectWise configuration steps above, proceed to configure the integration in Support Fusion:
- Navigate to Settings in Support Fusion
- Select ConnectWise from the platform dropdown
- Enter your configuration details:
- ConnectWise URL: Your API URL from Step 3 (e.g., api-au.myconnectwise.net)
- Company ID: Your ConnectWise company identifier
- Public Key: The public key generated in Step 2.3
- Private Key: The private key generated in Step 2.3
- Click Save Configuration
- Click Test Connection to verify the integration
Troubleshooting
Common Issues:
Authentication Failed:
- Verify both public and private keys were copied completely without extra characters
- Ensure the API URL matches your region (Step 3)
- Verify the API member account is active and not disabled
Permission Denied:
- Review the security role permissions match those listed in Step 1.2
- Confirm the API member is assigned the correct Role ID
- Check that the service board access is properly configured
API URL Issues:
- Use only the API domain (e.g., api-au.myconnectwise.net) without https://
- Ensure the region-specific URL matches your ConnectWise instance
- Remove any trailing slashes or additional path components
Board/Status Access Issues:
- Confirm the API member has access to the selected service board
- Verify the board exists and is active in ConnectWise
- Check that status options are available for the selected board
Resources: