Set up an LTI integration

How to register RaeNotes in your LMS and add the LMS as an LTI platform in RaeNotes. Do the steps in order — the LMS generates identifiers that RaeNotes needs, and RaeNotes publishes URLs that the LMS needs.

New to the integration? Read LMS integration (LTI 1.3) — overview first for the prerequisites. Every field mentioned below is explained in the LTI settings reference.

Setup steps

1

Open the Integrations page in RaeNotes

Click your profile picture and choose Integrations. The LTI 1.3 Integration section shows the three RaeNotes URLs your LMS will need, each with a copy button.

RaeNotes Integrations page showing the Login, Redirect and JWKS URLs
The Integrations page. Copy these three URLs — they are the same for every platform you register.

Don't see an Add LTI Platform button? The API-access feature is not enabled on your account. Contact us to have it switched on.

2

Register RaeNotes as an external tool in your LMS

Paste the three URLs into your LMS tool registration:

RaeNotes URL Example value What the LMS calls it
Login URL https://app.raenotes.com/lti/login Initiate login URL / OIDC initiation URL / Authorization (Login) URL
Redirect URL https://app.raenotes.com/lti/launch Tool URL / Launch URL, and Redirection URI(s)
JWKS URL https://app.raenotes.com/lti/jwks Public keyset / JWKS (Keyset) URL

Always copy the values from your own Integrations page rather than typing the examples above. Detailed, LMS-specific instructions: Moodle, LearnWorlds.

3

Collect the values your LMS generated

After you save the tool, the LMS produces the identifiers and endpoints that identify it to RaeNotes: Issuer (platform ID), Client ID, Deployment ID, Authentication request URL, Access token URL and Key Set URL. Keep that page open.

4

Add the platform in RaeNotes

Back on the Integrations page, click Add LTI Platform and fill in the LTI Configuration section with the values from step 3. Everything except Deployment ID is required.

Add LTI Platform dialog, LTI Configuration section
Issuer, Client ID, Deployment ID and the three platform endpoints, copied from the LMS.
5

Choose the team

In the Team section pick the team every launched student joins. Only teams you administer are listed, and the choice is final — it cannot be changed after the platform is created.

Use Existing RaeNotes accounts not in the team to decide what happens when a student launches with an email that already belongs to a RaeNotes account outside the team: Forbid login (the secure default) rejects the launch, while Create a separate account provisions a new LMS-bound account and leaves the original untouched.

Add LTI Platform dialog, Team section
The team students join, and how to treat emails that already exist in RaeNotes.
6

Choose the workflow

Select Upload only or Self-assessment with supervisor feedback. For self-assessment, also set:

  • Instructor email property — the name of the field carrying the instructor's email. Default instructor_email.
  • Instructor email sourceLTI launch custom parameter for Moodle and other LMSes that support custom parameters, or LearnWorlds webhook integration for LearnWorlds.
Add LTI Platform dialog, Integration Workflow section
The workflow radio group with the instructor-email fields shown for self-assessment.
7

Save, then reopen for the webhook URL (LearnWorlds only)

Click Add. If you chose LearnWorlds webhook integration, reopen the platform with the pencil icon: the Webhook URL is generated on save and only appears when editing. Copy it into the Send a Webhook action of your LearnWorlds automation, and paste your LearnWorlds signature token into the dialog — deliveries are rejected until it is set.

Edit LTI Platform dialog showing the generated Webhook URL and signature token field
The Webhook URL exists only after the platform is saved, and stays the same across edits.
8

Add the activity to a course and test it

Create the LTI activity in your LMS and open it as a test student. A successful launch lands on the RaeNotes upload page for that assignment. The platform now appears under Registered platforms, where you can disable, edit or delete it.

Registered platforms list with the enable switch, edit and delete buttons
Each row shows the issuer and client ID, with an Enabled switch, Edit and Delete.

Good to know

  • Disabling is reversible, deleting is not. A disabled platform rejects launches; a deleted one can be re-created with the same values, but it is a brand new registration and gets a new webhook URL.
  • The team cannot be changed later. If you picked the wrong team, delete the platform and register it again.
  • One platform per LMS registration. Register each Moodle site or LearnWorlds school separately — each has its own issuer and client ID.

Tip. Run the first end-to-end test with a real (small) recording so you can confirm the whole chain: launch → upload → processing → review → grade in the gradebook.

Any questions? Contact us