Skip to main content
All CollectionseConsult ToolbarSet up and support
Enabling toolbar integration with EMIS Web
Enabling toolbar integration with EMIS Web

How to sync the eConsult toolbar to EMIS Web

Laura Perring avatar
Written by Laura Perring
Updated over 3 months ago

When you first download and set up the toolbar you will need to set up the integration between the toolbar and EMIS.

This is necessary in order to use certain features such as:

  • Matching the patient in the Smart Inbox to the patient details in EMIS

  • Saving the eConsult into the patient record in EMIS

  • Opening the patient record in EMIS directly from the Smart Inbox

To set up integration between the toolbar and EMIS, please follow the steps outlined in this guide. You may also prefer to watch the video of these steps below.

Video Guide

Please note our toolbar login screens have changed but the steps are the same.


Step-by-step Guide

1. Activating the eConsult Health Partner API

Click on the EMIS Orb and navigate to EMIS 'System Tools' and then 'EMAS Manager'.

On the left-hand bar, select the 'Partner API' section. From the 'Partner API' list, select ‘eConsult Health’. This may also be displayed as ‘eConsult Messaging’.

From the header bar click 'Activate application'.


2. Authenticating users

With 'eConsult Health' or 'eConsult Messaging' selected and from this same header bar, click on 'Edit Users'. Select every user who you want to authenticate to use the eConsult toolbar with EMIS.

You also need to click on 'Login access' in the same header. For each user you authenticated in the previous step, you'll need to activate both 'Auto Login' and Allow Login' before clicking 'OK'.


3. Connecting the toolbar with your EMIS Org ID

You may need to update your toolbar version (as suggested by the toolbar itself) and then log out and back in to see the 'EMIS Org ID' field.

Your toolbar version should be 2.17.0 or higher if it’s updated. If it’s a lower number than that, it hasn’t updated itself yet. To find out what version of the toolbar you have at the moment, right-click on the three dots and go to 'Settings'.

When you log into the eConsult toolbar, you'll need to make sure you include your 'EMIS Org ID' which can be found on the EMIS login screen.

You will need to also enter your Practice Message ID and eConsult ID. You can find these at the top of any eConsult PDF report or by getting in touch at practice.support@econsult.health.

Finally, you need to Activate New Partner Product on the machine (this is a one time process that requires your EMIS username and Password). You'll see a window on your EMIS Web instance that looks something like this:

Smartcards can't be used to activate the product, so you will need to use your username and password. If you're not sure what your username and password are, you'll need to follow your normal process for gaining access to these (most likely contacting your IT department)

Once you've entered your details you should see this message if the activation has been successful:

If you're having any problems when you reach the toolbar login stage and wish to continue without the EMIS integration, you can click the 'None' option to continue without for the moment.


FAQs and troubleshooting

I don’t know my EMIS Org ID

  • When launching EMIS Web, you’ll see it on the login page just above the 'Sign In' button.

  • When EMIS Web is already open, you may see it on the far right of the text in the header bar of the application.

I can’t remember my EMIS Username and Password, I usually use a SmartCard

Unfortunately, we can only use a username and password, and can’t use a smart card to get this activation working. You have two options:

  • Contact your IT department and enquire about obtaining these credentials

  • Click ‘None’ option on the Toolbar login screen to proceed without EMIS integration for the moment

I clicked 'None' because at the time I didn’t know my details/didn’t want to set it up with EMIS yet. Now I’m ready to enable it

If you right-click to open the options, choose 'Settings', then click 'EMIS', you can set it up.

EMIS is running and logged in, but the Toolbar login window still says 'Please log in to EMIS'

You may have missed the step of our guide that requires you to go to 'Login Access' and check both boxes beside specific users.


​I am seeing a message saying 'Activate New Partner Product'

Make sure EMIS is running and logged in and ensure all the steps have been done properly. Alternatively, click 'None' to continue without for the moment.

I receive the message 'Cannot connect to EMIS Web, EMIS API failed when calling clinical system. Method initializewithID. error' on the login screen

Make sure EMIS is running and logged in for the screen to appear. Alternatively, click 'None' to continue without for the moment.

I see a message saying 'We couldn't find a match for your email address. Please go back and enter the email address you use to log into EMIS' on the login screen

Make sure the email address in EMIS is set to your NHS email address (or the email address you are using to login to the toolbar). You can check and change your EMIS email address by heading to the User Setup in EMIS.

I see the message saying 'EMIS returned an Exception: Object reference not st to an instance of an object.'

We recommend uninstalling and reinstalling EMIS - this is usually related to the CBD number on EMIS being incorrect.

I'm having problems connecting my EMIS instance with the toolbar

Connect to the toolbar using the 'None' option when you launch the toolbar. When the toolbar shows please right-click the 4 dots on the left of the toolbar and 'Report a problem'. Please type in a short message so that our support team have better details about your device and how we might be able to help you.

These questions relate specifically to how to set up your toolbar with EMIS - if you have any other toolbar questions, please check our more generic toolbar FAQ and troubleshooting article.


If you have any questions or you feel that this article could be improved, please feel free to give us some feedback. You can do this by emailing us, pressing the emojis below or using the chat button on the bottom right-hand side of this page to speak to one of the eConsult team.

Did this answer your question?