Quick setup guide for connecting your first PSA system to Super IT

Before You Begin

PSA integration is configured by manager teams who oversee multiple client support teams. If you're setting up PSA integration, you'll need manager team access in Super IT.

This guide walks you through connecting your first PSA system to Super IT and getting tickets flowing to the right teams.

Setup Timeline

timeline title PSA Integration Setup section Prepare Connect PSA System : API keys : Permissions : Testing access section Configure Link Companies : Team mapping : Route testing : Field mapping section Validate Test Integration : Ticket sync : AI functionality : Team workflows section Deploy Go Live : Team training : Monitor performance : Scale gradually

Estimated Timeline

🕐 Setup: 15-30 minutes
🔧 Configuration: 10-15 minutes
Testing: 5-10 minutes
🚀 Deploy: Immediate

Quick Setup Overview

  1. Connect your PSA system (ConnectWise or Halo PSA)
  2. Link companies/clients to your support teams
  3. Test ticket flow and AI integration
  4. Go live with full PSA integration

Step 1: Choose Your PSA System

🏢 Enterprise Integration

graph LR A[ConnectWise API] --> B[Super IT] B --> C[Team Routing] C --> D[AI Enhancement] classDef psa fill:#FFFFFF,stroke:#A7A9AC,stroke-width:1px,color:#24282C,rx:8,ry:8 classDef hub fill:#24282C,stroke:#808285,stroke-width:2px,color:#FFFFFF,rx:12,ry:12 classDef output fill:#58C4E5,stroke:#24282C,stroke-width:1px,color:#24282C,rx:8,ry:8 class A psa class B hub class C,D output linkStyle 0 stroke:#808285,stroke-width:2px linkStyle 1 stroke:#808285,stroke-width:2px linkStyle 2 stroke:#808285,stroke-width:2px

Best for: Established MSPs with complex workflows

Features: - Full ticket sync and company management - Custom field mapping capabilities - Multi-board configuration support - Advanced workflow integration

Requirements: - API member account with appropriate permissions - Company ID and API URL - Network access to ConnectWise servers

Set up ConnectWise →{ .md-button .md-button--primary }

🚀 Modern Integration

graph LR A[Halo PSA API] --> B[Super IT] B --> C[Client Mapping] C --> D[Real-time Sync] classDef psa fill:#FFFFFF,stroke:#A7A9AC,stroke-width:1px,color:#24282C,rx:8,ry:8 classDef hub fill:#24282C,stroke:#808285,stroke-width:2px,color:#FFFFFF,rx:12,ry:12 classDef output fill:#58C4E5,stroke:#24282C,stroke-width:1px,color:#24282C,rx:8,ry:8 class A psa class B hub class C,D output linkStyle 0 stroke:#808285,stroke-width:2px linkStyle 1 stroke:#808285,stroke-width:2px linkStyle 2 stroke:#808285,stroke-width:2px

Best for: Growing MSPs with modern infrastructure

Features: - Modern API connectivity with OAuth2 - Real-time webhooks for instant updates
- Streamlined client management - Asset synchronization capabilities

Requirements: - Admin access for OAuth app creation - Tenant ID and API base URL - Webhook endpoint accessibility

Set up Halo PSA →{ .md-button .md-button--primary }

🔗 Hybrid Approach

graph TB CW[ConnectWise] --> SI[Super IT Hub] HP[Halo PSA] --> SI INT[Internal] --> SI SI --> MT[Manager Team] MT --> T1[Team A] MT --> T2[Team B] MT --> T3[Team C] classDef psa fill:#FFFFFF,stroke:#A7A9AC,stroke-width:1px,color:#24282C,rx:8,ry:8 classDef hub fill:#24282C,stroke:#808285,stroke-width:2px,color:#FFFFFF,rx:12,ry:12 classDef team fill:#58C4E5,stroke:#24282C,stroke-width:1px,color:#24282C,rx:8,ry:8 class CW,HP,INT psa class SI hub class MT,T1,T2,T3 team linkStyle 0 stroke:#808285,stroke-width:2px linkStyle 1 stroke:#808285,stroke-width:2px linkStyle 2 stroke:#808285,stroke-width:2px linkStyle 3 stroke:#808285,stroke-width:2px linkStyle 4 stroke:#808285,stroke-width:2px linkStyle 5 stroke:#808285,stroke-width:2px linkStyle 6 stroke:#808285,stroke-width:2px

Best for: MSPs with diverse client requirements

Benefits: - Connect multiple PSA systems to one manager team - Route different clients through different systems - Maintain unified AI assistance across all systems - Gradual migration between PSA platforms

Setup Process: 1. Set up each PSA system separately 2. Configure team routing per system 3. Use team management to organize

Learn More →{ .md-button }

Step 2: Connect Your PSA System

ConnectWise Setup

You'll need: - ConnectWise company ID - API public/private key pair - ConnectWise server URL - Admin access to ConnectWise

Halo PSA Setup

You'll need: - Halo PSA tenant URL - Client ID and secret - API access permissions - Admin access to Halo PSA

Both integrations use secure, read-only access by default with optional write permissions for ticket updates.

Step 3: Configure Company/Client Routing

After connecting your PSA system, link specific companies (ConnectWise) or clients (Halo PSA) to your support teams:

For ConnectWise: 1. View synced companies in Super IT 2. Link each company to a managed team 3. Configure service board and status mappings

For Halo PSA: 1. Review synced clients in Super IT
2. Create client-team links for ticket routing 3. Set up webhook endpoints for real-time sync

Detailed instructions: Team Management Guide

Step 4: Test Integration

Verify Ticket Sync

  1. Check that existing tickets appear in Super IT
  2. Confirm tickets are routed to correct teams
  3. Test ticket status updates (if write access enabled)

Test AI Integration

  1. Open a ticket conversation with Sparky
  2. Verify Sparky can access PSA ticket information
  3. Test ticket creation and updates through AI

Check Security

  1. Review connection health in Super IT dashboard
  2. Verify webhook endpoints (Halo PSA)
  3. Confirm field mappings work correctly

Step 5: Go Live

Inform Your Teams - PSA tickets now appear in Super IT - Sparky can assist with all ticket types - Existing PSA workflows remain unchanged

Monitor Performance - Check sync status daily for first week - Review ticket routing accuracy - Monitor team adoption and feedback

Scale Gradually - Start with pilot teams or specific clients - Add more companies/clients as confidence grows - Connect additional PSA systems as needed

What to Expect

Immediate Benefits

  • Unified ticket view across PSA systems
  • AI assistance for all tickets
  • Automated routing to correct teams

Sync Timing

  • Initial sync: 5-15 minutes depending on ticket volume
  • Ongoing sync: Real-time (webhooks) or every 15 minutes (polling)
  • Status updates: Near real-time in both directions

Team Experience

  • No workflow changes required
  • Enhanced AI support for ticket resolution
  • Improved visibility into client ticket status

Common First Steps

Week 1: Pilot Testing - Connect one PSA system - Link 2-3 companies/clients to test teams - Verify ticket flow and AI functionality

Week 2: Gradual Rollout - Add remaining companies/clients - Train teams on AI-enhanced workflows - Monitor sync performance and accuracy

Week 3: Full Operation - Connect additional PSA systems if needed - Optimize field mappings and routing rules - Review analytics and team feedback

Getting Help

Setup Issues

  • Check troubleshooting guides for your PSA system
  • Verify API credentials and permissions
  • Contact Super IT support for connection problems

Team Training

Ongoing Support

  • Monitor connection health in Super IT dashboard
  • Review sync logs for any errors
  • Update API credentials before expiration

Ready to connect your PSA system? Choose your integration:

Questions? Contact your Super IT administrator or check our support documentation for additional help.