LTI troubleshooting

What to check when a launch is refused, a review is not created, or a grade never reaches the gradebook.

Launches are rejected

Symptom Cause and fix
Every launch fails, for everyone The platform is switched to Disabled on the Integrations page, or it was deleted. Re-enable it. If it was deleted, register it again — and remember the webhook URL changes.
Launch fails for one particular student That email already belongs to a RaeNotes account that is not in the platform's team, and Existing RaeNotes accounts not in the team is set to Forbid login. Either add the person to the team, or switch the setting to Create a separate account.
Launch fails right after registration Usually a mismatched value. Re-check Issuer, Client ID and Deployment ID against the LMS configuration page — they must match character for character — and confirm the LMS has the RaeNotes Redirect URL registered as a redirection URI.
The student sees a page with a button instead of RaeNotes (LearnWorlds) Expected. LearnWorlds embeds tools in an iframe; the button reopens RaeNotes in a new tab where the session works. See Set up LearnWorlds.

The review is not created

In the Self-assessment with supervisor feedback workflow the automatic review has four hard prerequisites. If any of them is unmet the review is skipped:

  1. The instructor's email actually reaches RaeNotes — the Moodle custom parameter is configured, or the LearnWorlds automation is active and its deliveries are accepted.
  2. That email belongs to an existing RaeNotes user. RaeNotes deliberately does not invite instructors automatically — they must sign up first.
  3. That user is a member of the platform's team.
  4. The team has a designated outcome model (set in team settings).

When a prerequisite fails, RaeNotes does not fail silently: the LMS gradebook entry is marked as failed and carries a comment of the form Auto-review skipped: <reason> naming what is missing. Read the reason, fix it, and ask the student to open the activity again — the next launch retries.

Remedy in one line. Fix the named issue, then have the student click the LMS activity once more.

Grades don't reach the gradebook

  • Moodle: the tool registration must have IMS LTI Assignment and Grade Services set to Use this service for grade sync and column management, and the activity must have Accept grades from the tool enabled.
  • LearnWorlds: the activity must be created as Exams → Graded LTI. Standard LTI activities under Multimedia never receive a score, even though everything else works.
  • Check the Access token URL in the RaeNotes platform settings — RaeNotes needs it to authenticate when posting grades back. A wrong value breaks grading only, so launches keep working.

The LearnWorlds webhook doesn't work

  • Deliveries are rejected — the LearnWorlds signature token in RaeNotes is empty or does not match the one under Settings → Developers → Webhooks in LearnWorlds.
  • Wrong webhook type — the email must come from an automation (Users → Automations → Send a Webhook), not from a school event webhook. The payloads differ.
  • Wrong property name — the payload's top-level property must match the Instructor email property field exactly (default instructor_email).
  • Stale URL — if the platform was deleted and re-created, its webhook URL changed. Copy the new one from the edit dialog into the automation.

Everyday behaviour that is not a bug

  • Clicking the activity again opens the existing recording rather than a new upload page. That is by design — one activity, one recording per student. If the recording is deleted in RaeNotes, the next click starts a fresh upload for the same assignment.
  • The Team dropdown is greyed out when editing. The team is fixed at creation. To move to a different team, delete the platform and register it again.
  • The Webhook URL is missing while adding a platform. It is generated on save — reopen the platform to see it.
  • No Add LTI Platform button. API access is not enabled on the account, or you do not administer any team.

Any questions? Contact us