Generating a Canvas Data 2 API Key
This article covers the creation of a Canvas Data 2 API key which we require to connect and retrieve data from customers using Canvas Data 2.
The Canvas Data 2 Client ID and Secret can only be created by an account admin.
Locate Customer
- In a web browser, visit identity.instructure.com.
In the institution drop-down menu, search for your institution by entering its name.
- If your institution does not appear in the search list, contact your Canvas Customer Success Manager for it to be added, with Canvas Data 2 enabled.
- You may need to use your Instructure url (e.g. edpotential.instructure.com)
Click the Log In to Canvas button.
Authorise Access
To authorise Identity Service to access your account, click the Authorize button.
Add New Key
- To add a new key, click the Add New Key button.
Enter the settings for the key:
- Key Name [1]: EdPotential
- Expiry [2]: 3 years (or the maximum available period)
- Key Type [3]: Institutional Use
- Click the Save button [4].
Copy API Key and Secret
- To reveal your Client ID and Secret, click the Reveal OAuth Credentials button [1].
- To copy your Client ID and Secret, click the Copy Text button next to the Client ID and Secret fields [2].
- To avoid accidental closing before copying the Client ID and Secret, you need to click the Click 3 more times to close button [3].
- The Client ID and Secret window can only be opened one time. When you close it, you cannot reopen it.
- If you do not copy the generated Client ID and Secret and close the window, you will need to generate a new Client ID and Secret.
Provide Credentials to EdPotential
Using this form or a password manager, securely provide EdPotential with:
- The Client ID
- The Secret
- The expiry date
Make a note of the expiry date for the Client ID and Secret, as this will not automatically renew.
A new Client ID and Secret will need to be created and provided to EdPotential before this date, to ensure unbroken data transfer.