Skip to main content
All CollectionsJoyConnectInstalling JoyConnectJoyConnect Central IT Installation
Setting up the EMIS and Joy Integration - Common Issues
Setting up the EMIS and Joy Integration - Common Issues

This article outlines the common problems when setting up Joy within EMIS and what steps to take to resolve them.

Support at Joy avatar
Written by Support at Joy
Updated over 3 months ago

📍 This article includes the following errors:

  • You see an error or ‘Kittens’ when hitting the Social Prescribing button

  • You see 'Connection Error' when you set up the integration in EMIS


You see an error or ‘Kittens’ when hitting the Social Prescribing button

Details that you entered in EMIS during the setup are incorrect. To check this please follow the below steps within EMIS:

Select the following options:

1. Click the EMIS ball

2. Click "Configuration" 👇

3. Then, click "Organisation configuration" 👇

4. Click “Organisation” 👇

5. Click on your surgery and then click on “Edit” 👇

6. Find Social Prescribing in the list and click it 👇

Select the following options:

  1. Portal access: Enabled

  2. Require logon details: Yes

  3. Enter your username ✍️:

    • Please check this next step carefully:

      • Joy[Your ODS code] (for example, if your ODS code is N81006, your username would be: JoyN81006)

      • Password: Monday123

        If EMIS does not allow you type Monday123 - then please enter Monday1234, press save and then re-open the window and type Monday123. It will work the second time.

4. Click "OK" 👇

5. When EMIS asks if you want to log out, choose “Yes” 👇

6. Log back in and try the steps with a test patient again

7. If you still see the Kittens error please email 📧 [email protected] with the following Subject line: EMIS Set up Error Kittens (Insert Practice name)


You see 'Connection Error' when you set up the integration in EMIS

There are numerous reasons this could happen, please follow the steps below which will help resolve this issue:

Solution One: When setting this part up you may have put your ODS code into the Joy connection, instead of EMIS code

Please note that the EMIS code is usually 1 to 5 numbers, whilst the ODS is a letter followed by 5 numbers. If you have entered it incorrectly, ensure you re-enter it correctly.


Solution Two: You may have missed an RBAC code when you created the Joy user within your EMIS

  • To check this please revisit Creating Joy as a user in EMIS (add link when article is live)

  • Please make sure the Joy App user has all 9 of those RBAC codes added

    • In most cases, the B8029 - Managed Detailed Records does not add correctly the first time

If any codes have been missed, ensure you enter them correctly to fix this error.

Solution Three: There is a password error Part 2 of the EMIS integration.

This means the user may not have been given full access.

Please follow the below steps:

  1. Click the EMIS ball 👇

  2. Choose “System Tools” 👇

  3. Choose “EMAS Manager” 👇

  4. Choose "Partner API" 👇 from the bottom left

  5. Find and then select "Joy" 👇 from the list

  6. Double-check Joy is activated, Joy ✔️ will have a green tick beside the name once it’s been activated

  7. Make sure "Joy" is selected

  8. Click “Edit Users” 👇

  9. Find the name 🔍

    • “App, Joy”

    • “Partner, API” with username APIUSER

    • And any social prescribers/health coaches/care coordinators or members of the personalised care team. Please don’t untick any users who are already ticked.

  10. Tick the box next to their name ☑️ as shown in the image below:

  11. VERY IMPORTRANT: Please select 'Change Password' 👇 and Set password(s) as Monday123 ✍️

Please ensure that this password has been typed in correctly. If it hasn’t been typed in correctly, you will be unable to connect to Joy. This must be completed for:

  • APP, Joy (JOYCONNECT)

  • PARTNER, API (APIUSER) ****(only if you have this)

  • And all members of the personalised care team

12. Click OK 👇

13. Click “Log in Access” 👇 and find the name:

  • “APP, Joy” JOYCONNECT

  • “PARTNER, Api” APIUSER

  • And any social prescribers/health coaches/care coordinators.

14. Tick both boxes for “auto” ☑️ and “allow login” ☑️

Please don’t untick any users who are already ticked

15. Click “OK” 👇
16. Please log out and log back into EMIS for all changes to take effect! 🎉

Did this answer your question?