How to set up Canvas with a new API Key for membership and grades for the PebblePad integration.

Where a previous LTI integration has already been installed (e.g. LTI 1.1) you can skip to Step 11.


Open video full screen

The API requires authentication from a user account with an administrator role. It is advisable to use a dedicated ‘Service Account’ and not a person's actual account. This will provide adequate security and ensure consistency of service, unaffected by people moving or leaving jobs.

Follow Canvas docs to create a new admin user 

1: Go to Developer Keys

Login to Canvas with the dedicated Service Account

Within the Canvas Admin panel, navigate to Developer Keys in the sub-menu.

2: Add Developer Key

From the +Developer Key button, choose +API Key from the dropdown menu.

3: Input Key Settings

In the text areas, add the following information and Save.

Key NamePebblePad
Owner email[your email address]

Redirect URIs

- TAQAS Staging (all locations)
- Australia (production)
- Canada (production)
- UK (production)
- US (production)

Icon URL
Enforce ScopesDisabled

4: Turn On Tool

Using the toggle, turn on the status of the Developer Key.

5: Note ID & Key

In the Details column, take note of the Client ID and use the Show Key button to reveal the Client Key. These details are needed for Step 9 below.

6: Login to PebblePad

Go to your PebblePad install and login using an account with PebblePad Global Administrator permissions.

7: Navigate to Global Admin

Use the Burger Menu to navigate to Additional Settings > Administration.

8: Select Integrations Tab

From the tab menu, select Integrations and from the sub menu beneath, Canvas.

9: Input Setting Data

Tick the field, Override the default PebblePad Client ID and Secret.

In the text areas, add the following information and Save (where you will be redirected back to Canvas)

Canvas URLCopy from address bar of your Canvas login screen (include /)
Client IDObtained in Step 5 (above)
Client KeyObtained in Step 5 (above)

10: Authorise Tool

  • Login to Canvas using the same credentials as before and Authorise the tool from the confirmation modal.
  • You'll be redirected back to Canvas set-up page in PebblePad Global Admin. 
  • The API tool is now configured.

11 Share data with PebblePad Support

If you have not already done so, download the .csv file below and complete with the required information. The Development ID can be located in Step 7 from Stage 2.

Follow this guide to upload to your PebblePad account and share the file with PebblePad Support.

Please ensure you update the Integration Journey Planner, marking stages 1-3 as complete. This will alert our PebblePad Implementation Engineer to action Super Admin settings. You will be contacted when completed to proceed to stage 4. 

Stage 4 - End-to-End Test >