GradeHub for Canvas - How to setup GradeHub in Canvas

How to setup GradeHub in Canvas

Before you begin, you'll need to have your GradeHub admin login and have admin login access in Canvas. It is easiest if you have two tabs open in your web browser, one for Canvas and the other for GradeHub.


A numeric SIS_userID with a maximum length of 10 characters and an email address is required in Canvas for all student accounts.

To install the GradeHub plugin for Canvas:

Step 1 — Define a Developer Key for the GradeHub LTI App in the Admin section of your Canvas Account:

1. Select Admin > Developer Keys > Account and then select + Developer Key
Important Fields:
Email: Recommend an Admin User email
Redirect URI / Redirect URIs (note: Canvas is still transitioning away from the legacy field so for best results populate both fields with the following value): 
Icon URL

2. Step 2 — Confirm your Developer Key has been created and is active

Note: some of the values will vary, but the URI and the State should match what is pictured above.

Step 3 — Login to your GradeHub Admin Account and Initiate the OAuth2 Permissions Flow

Click on the “Settings” button for your Organization; this will Launch the Integrations Configuration modal window.

  1. Ensure that you are using the Client ID and Secret from the Developer Key you created for GradeHub in Step 1. 
    The URL field should be that of your own Canvas account.
  2. If you haven’t already generated your LTI Launch key set, please do so now — you will need to supply these values in your GradeHub LTI App configuration in Canvas.
  3. Finally, once all the fields are populated appropriately, click the “Activate” button to initiate the OAuth2 Permission Flow. This will open a new tab, so ensure that your browser is not blocking that behavior before proceeding.

Step 4 — Grant GradeHub access to your Canvas Account on your behalf. 

Please note that this step should only be performed by an IT Admin user for the Canvas account. GradeHub uses OAuth to identify & authenticate a single Admin User through which to programmatically manage & execute its Canvas integration activities.  Select “Authorize” to proceed. You should now observe a message stating that the permissions have been established, and you may close out the tab opened by the OAuth process.

Step 5 — Return to Canvas to add GradeHub LTI App and confirm

1. Select Admin > Settings > Apps and then type GradeHub in the search bar
2. Click on the GradeHub tile
3. Select + App
 4. Copy the Consumer Key and Shared secret from GradeHub in Step 3 above to the Canvas window below
3. For the GradeHub App just added, select Edit under the Cog icon in Canvas to confirm your configuration.

Please note that if during the preceding steps you created or updated your LTI Consumer Key or Shared Secret in GradeHub you will want to ensure they are recorded here.

Did this help answer your question?

thumbs up
thumbs down

Thanks for the feedback! 🙏🏽