Embed TopLeft in ConnectWise as a tab

Embedding in ConnectWise is available in Standard plan.

TopLeft boards can be embedded in ConnectWise Manage as a tab. This makes TopLeft even easier to use, because technicians don't need to leave ConnectWise to use it. They also don't need to log into TopLeft, as TopLeft uses authentication data provided by ConnectWise.

For more information on embedded tabs, review the ConnectWise documentation.

Unfortunately, card drag and drop doesn't work when using the ConnectWise Manage Windows client. We believe this is due to a limitation in the internal design of the Windows client. Card drag and drop works fine from the ConnectWise Manage web application.

Adding an Embedded TopLeft Tab to ConnectWise

To add an embedded TopLeft tab in ConnectWise, follow these steps. This requires administrator privileges.

  1. Navigate to the TopLeft Kanban board that you want to add to ConnectWise.
  2. Click the Edit button beside the board name. 
  3. Click the Actions button, then click Embed in ConnectWise.
  4. In the dialog, select the ConnectWise screen where the tab should appear.
  5. Click Submit.

If you get a message that you do not have security permission to perform this action, you'll need to update the security role settings for the TopLeft API member- see Configuring ConnectWise Manage Security Roles and API Members.

These steps register the TopLeft Kanban board as an available tab in ConnectWise but it doesn't make it visible for all members. Follow the instructions in the next section to display the TopLeft tab in ConnectWise. Each ConnectWise member will need to select the tab as a displayed tab to view it.

Viewing an Embedded TopLeft Tab in a ConnectWise Screen

Before viewing TopLeft in ConnectWise, you may need to add the tab from the tab configuration menu.

  1. Navigate to the screen in ConnectWise where the tab is registered (i.e. Today, Project, Company, etc.)
  2. Click the gear icon to open the tab configuration menu.
  3. Select the TopLeft tab and click the right arrow to move to the "Displayed" column. If you don't see the tab listed, ConnectWise may be showing you old cached data. Log out, clear your browser or client cache, then log in and try again.
  4. Click "Save". The TopLeft board appears as a tab.
  5. Click the tab to open your TopLeft application in ConnectWise.

In the TopLeft app, shift-click a card title to open it in the same browser/client tab. The page opens quickly because it uses the existing ConnectWise application context.

Removing an Embedded TopLeft Tab from ConnectWise

To remove an embedded TopLeft tab from ConnectWise Manage follow the steps below. You will need access to the ConnectWise Setup Tables.

  1. To open the Setup Tables, click System → Setup Tables
  2. In the Table search box enter, "Manage Hosted API" and click search.
  3. Select "Manage Hosted API" from the list.
  4. Click the TopLeft tab you want to remove.
  5. In the tab edit page, click the delete iconand click OK to confirm.

Adding an Embedded TopLeft Tab to ConnectWise using the Setup Tables

In addition to adding a TopLeft tab via the method in TopLeft, you can add a tab manually in ConnectWise. Follow these steps:

  1. To open the Setup Tables, click System → Setup Tables.
  2. In the Table search box enter, "Manage Hosted API" and click search.
  3. Select "Manage Hosted API" from the list.
  4. Click on the "+" button to create a new tab.
  5. In Description, enter "TopLeft" or some other name- it's up to you.
  6. In Screen, choose where the TopLeft tab will be visible. The most easily-accessible screen is the Today Screen, but you can choose any of the options listed.
  7. Set Origin to the URL of your TopLeft application. For example: "https://example.topleft.team/".
  8. Set URL to the special URL of the board you want to appear in the tab. To get this URL, from the TopLeft application edit the board and click the "Embed in ConnectWise" button. A dialog showing the URL opens- copy the URL and paste it into ConnectWise.
  9. Save the tab by clicking the disk icon .
  10.  To view your embedded TopLeft tab, follow the instructions in the Viewing an Embedded TopLeft Tab in a ConnectWise Screen section.


  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Configuring TopLeft to use ConnectWise Member API Keys

TopLeft can make changes to tickets, projects, and other records as if an individual ConnectWise...

Synchronizing Data Manually

TopLeft synchronizes data with your PSA in a few ways. In addition to real-time notifications and...

Using ConnectWise Priority Colours On TopLeft Tickets

Configuring Ticket Priority ColoursTopLeft shows the priority of a ticket by the colour of the...

Configuring TopLeft to Keep ConnectWise Closed Tickets

By default, TopLeft doesn't sync closed tickets from ConnectWise Manage. This also means that any...

Disabling Users

To prevent a user from accessing TopLeft, do either: To prevent the member from using both...