Skip to main content
All CollectionsIntegrationsPSA Integration Guides
Kaseya PSA - Installation Instructions
Kaseya PSA - Installation Instructions
Updated today
  1. Kaseya Integration Overview

    The Kaseya integration is designed to create a sync of key Company information to allow you to run reports on important metrics in your MSP.
    Here are the areas that we sync.

    1. Companies
      You can map companies between SO and Kaseya and sync from from Kaseya into SO

    2. Company Types
      System provides bi-directional Types sync. You can map company types between SO and Kaseya and changes in Kaseya will update SO and from SO to Kaseya too.

    3. Company Status
      You can map company status between SO and Kaseya and changes in Kaseya will update SO (active/inactive flag in Kaseya equals to Active/Inactive status in SO). This sync only from Kaseya to SO.

    4. Configurations Status
      Syncs from Kaseya

    5. Configuration Types
      Syncs from Kaseya

    6. Configurations (Assets)
      Syncs from Kaseya

    7. Contacts/Managed users
      Coming soon

    8. Tickets
      Coming soon

    9. Projects
      Coming soon

    10. Agreements
      Coming soon

    11. Opportunities
      Coming soon



  2. Kaseya , create API User

    1. Add API User: Admin--> HR--> Employees--> New

      Username: email you have access to or APISO
      Emp ID: API SO

      Department: Administration

      Employee roles: Administration

      User type: API Employee

      First name: API SO

      Email address: Address you have access to (email must be unique within Kaseya database, so you won't be able to use the same email for API-agent and regular agent)

      Manager: Select admin account

      Security Roles: Administrator, CRM Manager, Service Desk manager

      Job Title: Administrator or select any other field

      Location: Main Branch

    2. Save: Press

    3. Email inbox (your API User email): follow the link, setup the password

  3. Allowlist IPs
    If your Kaseya environment can only connect to allowed IPs please allow list the following IPs
    52.247.76.89
    52.247.76.111
    52.247.76.163
    52.247.76.166
    52.247.76.170
    52.247.76.201
    20.49.97.4

  4. Add Integration in Strategy Overview

    1. Add Integration: Settings --> Integrations --> Add Integration --> Kaseya
      Note: only one PSA integration allowed at once.

    2. URL: Input a URL address you use to login into Kaseya, for example:
      https://na1bmspreview.kaseya.com

    3. Tenant: your tenant name

    4. API user name : user name you've create before (email or "APISO")

    5. API User password: user password you've set be following the email link

    6. Add Integration: press

  5. Company Types

    1. Enable bi-directional Company Types sync:

      1. Check for full sync - all list of Types will be always updates:

        Map Companies: Map company types strategically. Kaseya will overwrite anything you mapped. For example. If in Strategy Overview you call clients "Client" and in Kaseya you call them "Customer", when you map Customer to Client it will update Strategy Overview to "Customer" when you save the mapping

        Create UnMapped button: Click (This will create all Kaseya Company Types in Strategy Overview and automap.)

        Save

      2. Or skip the step - to sync only Types which will come with mapped companies.

  6. Company Statuses

    1. Enable Company Statuses sync with Kaseya : Check

    1. Map Statuses: Kaseya has only two statuses : active and Inactive .

    2. Create UnMapped button: Click (This will create all Kaseya Company Statuses in Strategy Overview and automap)

    3. Save

  7. Companies

    Its best practice to import only Managed clients that are in active Strategic Planning. You do not want to clutter SO with all potential leads, vendors, etc.

    1. Import Companies (button on the right part of the table): Click

    2. Types: Please select the type used for your Managed Clients. Strategy Overview accounts can have unlimited users but are limited by number of Managed Clients in the system used for Strategic planning. This allows us to provide fair pricing for any MSP at any size.

    3. Company Statuses: Usually you only want to import Companies that are Active

    4. Integration Status: All

    5. Load Companies: Click Load Companies and select Companies you want to Import into the system to use for strategic planning. If you already had companies in Strategy Overview and they had the exact same company name, it will automatically map. If you did not, you need to press "Create unmapped" to create them in SO.

    6. Save Mapping

  8. Configurations

    1. Enable sync Configurations with Kaseya : Check

    2. Fields Selection tab:

      1. Fields to download: Check all fields you want to bring into SO

      2. Fields to map: Map your Kaseya fields with SO fields to use all SO features.
        System shows in dropdown only fields you have selected in "Fields to download" section:

        1. Serial number

        2. Notes

        3. Purchase date: We use Purchase date to count Age in SO. If you don't have Purchase date, you can use Install Date.

        4. Expiration date: We need this field to update Expiration date for asset by our Warranty Service in Your PSA. Sync back option disabled by default, you can select if you want to update this data or not later during Warranty Service setup.

        5. RAM

        6. OS Type

        7. Manufacturer Name

          Please, map all required fields. If you don't see needed field in mapping dropdown, then
          1) make sure you have chosen them in "Fields to download"
          2) you can create as custom needed fields in Kaseya : Admin--> MyCompany --> Custom fields --> New:
          - Field Name: Input.
          - Type of filed: select.
          - Module name: Physical assets.
          Save: click.

      3. Save mapping: click

      4. Configuration Selection: This is the place where you can select filters for Assets you want to bring into SO.

        1. Mapped Companies: select "All" (means all assets from all companies will be added in a feature, even if you map new companies).

        2. Types: select asset types you want to bring into SO (Servers, Workstations etc.)

        3. Statuses: we recommend to select only "Active"

      5. Import configurations: Click

  9. Configuration Settings

    This is the place where you define rules for your configurations.
    You can find configuration settings using two ways:
    1) Settings - Configurations
    2) Settings - Integrations - Open integration - Configurations - Configuration Selection - "Configurations settings" button.

    1. Create Template Configuration: This is the template your configurations will be associated with.

    2. Add

    3. Grades: Review the default grades that come with the system. Grades allow you to grade configurations and identify which are healthy and which need to be upgraded/retired.

  10. Classes
    Classes are types of configurations. Examples are:
    Managed Workstations
    - Basic
    - Premium
    - Engineering

    1. Open Classes: Classes Tab/Select Configuration Type (Example: Managed Workstation)

    2. Create Class: Click and name the class (Example: Basic)

    3. Budget: Set budgets (You can select an approximate budget for the hardware, setup and onsite charges if your MSP bills that.

    4. Other Classes: Create any other classes that are useful. Other examples are form Firewall (1-10 Users, 11-20 Users, 21-40 users, etc)

  11. Configurations Template Settings

    1. Open Settings: Template Settings Tab/Click template name

    2. Configuration Types: Only select those that are relevant for asset tracking to show in build mode or Display Mode

    3. Configuration Status: Only select those that are relevant for asset tracking to show in build mode or Display Mode

    4. Configuration Columns: These are the columns that display for the Assets tab. We preconfigured them to show just the right information you may want to show. You can always edit these later. Please note, by default we do not enable recurring budget columns for Assets. If your MSP sells/leases/rents computers on a monthly basis you can enable that.

  12. Create your first report!

    1. Create Report: Companies module/Find the client you want to make a report for. (If you already have a draft open, the assets tab will already show. If you only have completed reports, click New Report icon next to the company name to make a new report.)

Did this answer your question?