Skip to main content

Canvas Troubleshooting

Common issues and their solutions when integrating DebaterHub with Canvas LMS.

Launch Issues​

"Invalid Client ID" Error​

Symptoms: Error message when attempting to launch DebaterHub from Canvas.

Causes & Solutions:

  • Verify the Client ID is copied correctly (no extra spaces)
  • Check the Developer Key is set to ON in Canvas Admin
  • Ensure you're using the LTI Client ID, not the OAuth Client ID

"Tool Launch Failed" Error​

Symptoms: Canvas shows a generic launch failure.

Causes & Solutions:

  • Verify the redirect URI exactly matches: https://app.my-desk.ai/canvas/callback
  • Check that the JWK URL is accessible
  • Ensure the Canvas domain is correctly configured in DebaterHub

Tool Not Appearing in Course Navigation​

Symptoms: DebaterHub doesn't show in the course sidebar.

Causes & Solutions:

  • Verify the tool is added to the specific course (Settings > Apps)
  • Check that "Course Navigation" placement is enabled in the Developer Key
  • Try removing and re-adding the tool to the course

Grade Passback Issues​

"Grade Passback Failed" Error​

Symptoms: Grades aren't syncing to the Canvas gradebook.

Causes & Solutions:

  • Verify OAuth scopes include submission update permissions
  • Check the OAuth Developer Key is enabled
  • Ensure the instructor has authorized grade sync (they'll see a prompt)
  • Verify the assignment exists in Canvas with correct settings

Grades Show as "Pending"​

Symptoms: Grades appear in DebaterHub but not in Canvas.

Causes & Solutions:

  • Allow up to 5 minutes for grade sync
  • Check Canvas for any assignment configuration issues
  • Verify the OAuth token hasn't expired (re-authorize if needed)

User & Permission Issues​

Wrong User Role Displayed​

Symptoms: A teacher appears as a student, or vice versa.

Causes & Solutions:

  • Canvas roles are mapped automatically - verify the user's Canvas role
  • Custom Canvas roles may need to be mapped - contact support
  • Check that role scope is included in the LTI launch

User Can't Access Course Content​

Symptoms: Student launches but sees no assignments.

Causes & Solutions:

  • Verify the student is enrolled in the Canvas course
  • Check that assignments are published in Canvas
  • Ensure the LTI launch includes course context

Still Need Help?​

If you're still experiencing issues:

  1. Check our status page: status.my-desk.ai
  2. Contact support: support@my-desk.ai
  3. Include in your request:
    • Canvas instance URL
    • Error messages (screenshots if possible)
    • Steps to reproduce the issue