This guide walks through connecting Mindjoy to Moodle as an LTI 1.3 external tool. The setup involves four phases: copying Mindjoy's configuration values, configuring the tool in Moodle, registering Moodle as a platform in Mindjoy, and adding Mindjoy activities to your courses.

Before configuring Moodle, get Mindjoy's LTI values.

1. Log in to Mindjoy

2. In the left sidebar, click Organization (the building icon at the top)

3. Click Integrations in the settings menu

4. You will see the LTI 1.3 Settings page with a section called Mindjoy Tool Configuration

5. There are five values to copy. Keep this page open - you will need these in the next step:

Each value has a copy button next to it. Click to copy.

1. Log in to Moodle as an administrator

2. Go to Site administration in the left sidebar

3. Navigate to Plugins > Activity modules > External tool > Manage tools

4. Click configure a tool manually (link at the bottom of the page)

Fill in the following fields:

After selecting LTI 1.3, additional fields will appear. Fill them in:

Scroll down to the Services section:

These settings are critical. If not set correctly, Mindjoy will reject the LTI launch with a 401 error because it requires the user's email address to authenticate.

Do not use "Delegate to teacher" for name or email. In Delegate mode, Moodle does not send user information during deep linking (content selection) because there is no activity instance at that point. This causes Mindjoy to return "Email not provided in LTI claims".

5. Click Save changes

6. The tool now appears in the list. Click on the tool name or the gear icon to view its configuration.

7. Note down two values you will need for Phase 3:

Client ID - Moodle generates this automatically. It is shown on the tool configuration page (e.g. EKBLvXDP1zvIRFg).

Deployment ID - This is the tool type ID. You can find it in the URL when editing the tool - look for id= in the address bar (e.g. ...action=update&id=2 means the Deployment ID is 2).

You will also need your Moodle Site URL. This is the base URL of your Moodle instance (e.g. https://moodle.yourschool.edu). You can confirm this in the browser address bar - it is everything before /mod/... or /admin/....

1. Go back to Mindjoy's LTI 1.3 Settings page (Organization > Integrations)

2. Scroll down past the "Mindjoy Tool Configuration" section

3. Click the + Register LTI 1.3 Platform button

4. A dialog titled Register LTI 1.3 Platform will appear

Fill in the fields using values from your Moodle instance. Replace https://moodle.yourschool.edu with your actual Moodle site URL throughout.

5. Click Register

Once the integration is configured, teachers can add Mindjoy activities to their courses.

1. Navigate to a course in Moodle

2. Click Turn editing on (top-right button or gear menu)

3. In the topic or section where you want to add Mindjoy, click Add an activity or resource

4. Select External tool from the activity chooser

5. In the Preconfigured tool dropdown, select Mindjoy

6. Click the Select content button - this opens Mindjoy's content picker in a popup or modal

7. In the Mindjoy picker, choose the tutor, pathway, or lesson you want to embed

8. The activity name and settings will be populated automatically

9. Adjust any other activity settings as needed (e.g. grading, availability)

10. Click Save and return to course or Save and display

Students will now see the Mindjoy activity in their course and can launch it directly.

The Supports Deep Linking checkbox is not enabled on the tool.

Fix: Go to Site administration > Plugins > External tool > Manage tools, edit the Mindjoy tool, and check Supports Deep Linking (Content-Item Message).

Moodle is not sending the user's email address in the LTI launch token.

Fix: Edit the Mindjoy tool configuration and set Share launcher's email with tool to Always (not "Delegate to teacher").

The LTI launch is failing. Open your browser's developer tools (F12) and check the Console tab for the specific error message. Common causes:

Moodle is behind a reverse proxy or load balancer that terminates SSL, but Moodle doesn't know this.

Fix: Add the following line to your Moodle config.php file:

This message appears when the LTI launch returned an error. The underlying error page cannot display inside the iframe due to browser security restrictions. The actual error is one of the above - check the browser console's Network tab for the response from api.mindjoy.com/lti/launch to see the real error message.

Check that the activity-level privacy settings also have name and email sharing enabled. When editing the External tool activity, expand Privacy and ensure Share launcher's name and Share launcher's email are checked.

Replace https://moodle.yourschool.edu with your actual Moodle URL.