Setting up the Kaseya BMS integration

Overview

Use this step-by-step guide for configuring ConnectBooster to synchronize with BMS. 

Once completed, your ConnectBooster portal will then be able to pull Accounts, Contacts, Contracts, and more to help leverage AutoPay, and supercharge your Billing Automation!

Preparation

To perform the integration setup, you will need:

  • Admin access to Kaseya BMS
  • Admin level access on your ConnectBooster "Internal User"  account

Part 1: Configuring BMS

1. Take note of your BMS Company Name. This value will be used during the setup portion inside your ConnectBooster portal. Your Company Name should be the same value used on the BMS Log in page.

Creating a dedicated API Employee (recommended)

The User Type of "API Employee" is a special type that does not have access to the User Interface of BMS (more information on this can be found here).

2. To generate a dedicated API Employee, navigate to Admin + HR + Employees + New

3. On the New Employee creation page, fill in the series of required fields denoted by asterisks/red boxes with the values of your choosing.

The three notable fields to pay attention to:

  • User Type (Set to API Employee)
  • Email Address (Set to an inbox you can retrieve the emailed password, as this User Type can not manually set a password)
  • Security Role (Note: While a role like "Administrator" will work, it is more access than what ConnectBooster actually needs)
    • To set paired down permissions, please follow the optional steps outlined in the next section below.

4. Save to create the new User.

5. Use the Reset and Email Password button.

6. The email address used should receive the credentials. 

Creating a dedicated Security Role - (OPTIONAL)

NOTE  It's possible any future features/enhancements may require permission changes to a Role set with bare minimum permissions outlined below.

Navigate to Admin + Security + Roles. Create "New".

NOTE  The User Type "API Employee" can NOT have a Security Role Type set to "External"

Role Permissions

Important "Special Features" option:

Be sure to set "Has API Access", under the Admin permissions accordion.

Save your changes, and proceed to assign the API Employee this new Security Role.

Part 2: ConnectBooster setup

Next, within your ConnectBooster portal, navigate to Integrations.

Select the Kaseya integration card + Settings

NOTE  If this integration does not exist for you, please contact support@connectbooster.com to have this added to your portal.

Enter the credentials:

1. Your Company Name (on the BMS Login Page)

2. Username (User with admin credentials, or a dedicated API Employee)

3. Password

4. Default BMS Server endpoint (bms.kaseya.com)

5. Don't Forget to Save!

Next, validate the credentials via the "Test Connection" button.

Once you see the successful confirmation toast, you should be all set! The connection is complete!

A sync will begin within the hour, otherwise you may immediately initialize via the "Sync Now" button.

Selecting the invoice image

Utilize this function to allow your clients to view/print the identical invoice template from BMS.

Invoice image data

Navigate to Configurations + Billing + Invoice Image Data.

Check the box for the BMS integration, and move it to the top of the list if you have multiple sources of invoices. Don't forget to Save your changes!
Congratulations! You have now setup the invoice image data. 

  • More information regarding how this, and the related functions impact your portal behavior please see this article.

If you encounter issues, please don't hesitate to contact our team at support@connectbooster.com.

If the Kaseya BMS integration does NOT exist, please contact ConnectBooster Support for creating NEW integrations or when CONVERTING current platforms.