How Do I add a Developer Key for Perceivant?

To enable Perceivant access to Read-Only data from your Canvas instance, you will need to create a developer key and provide some information back to Perceivant.

Once the key is set-up, send the following information to Perceivant:

• The number above the Show Key button 
• The dev key (click Show Key) 
• Your Canvas URL  

Set Up Developer Key

1. In Global Navigation, click the Admin link, then click the name of the main level account.
2. In Account Navigation, click the Developer Keys link.
3. Click the Add Developer Key button.
4. If you have enabled the LTI 1.3 and LTI Advantage feature option in your account, you will also need to click the Add API Key option.
5. Enter the settings for the developer key:
   • Key Name: Perceivant Data
   • Owner Email: help@perceivant.com
   • Redirect URI: https://lti.perceivant.com/oauth/associate_admin_callback
   • Redirect URIs: <leave empty>
   • Vendor Code (LTI 2): <leave empty>
   • Icon URL: <leave empty>
   • Notes: This key has been created to enable Perceivant API access for data analysis
   • Test Cluster Only: <leave empty>
6. Click Enforce Scopes.
7. Select the following scopes (Be careful. Many of the scope names look very similar.):

Accounts

url:GET|/api/v1/accounts -- Used to obtain the list of accounts for use in filtering

url:GET|/api/v1/accounts/:account_id/courses -- Used to obtain a list of courses in each account for collecting information on each course

Analytics

url:GET|/api/v1/courses/:course_id/analytics/student_summaries -- Used to obtain participation data for students in the course

Assignments

url:GET|/api/v1/courses/:course_id/assignments -- Used to obtain a list of assignments in the course

url:GET|/api/v1/users/:user_id/courses/:course_id/assignments -- Used to obtain a list of assignments for a specific student for the course

Conversations

url:POST|/api/v1/conversations -- Used to send messages via Canvas's built-in messaging directly from the Instructor Dashboard when installed

url:GET|/api/v1/conversations -- Used to obtain a list of conversations for a specific student for display

url:GET|/api/v1/conversations/:id -- Used to obtain messages in a specific conversation for displaying conversation data in our app

Courses

url:GET|/api/v1/courses/:id -- Used to get course information (name, timezone)

Enrollments

url:GET|/api/v1/courses/:course_id/enrollments -- Used to get a list of the students in a course

Enrollment Terms

url:GET|/api/v1/accounts/:account_id/terms -- Used to obtain a list of terms for use in filtering

Quizzes

url:GET|/api/v1/courses/:course_id/quizzes -- Used to get quiz information for a course

Submissions

url:GET|/api/v1/courses/:course_id/students/submissions -- Used to get submission information for a course (late, missing, grade)

Users

url:GET|/api/v1/accounts/:account_id/users -- Used to obtain a list of users for gathering per-student data

url:GET|/api/v1/users/:id -- Used to load information on an individual student as to not have to pull back the list of students for an entire account

url:GET|/api/v1/users/:user_id/page_views -- Used to display information on a student's activity within a course (when the opened assignments, quizzes, study materials)

url:GET|/api/v1/users/:user_id/profile -- Used to verify the developer credentials

8. Click the Save Key button.
9. View the Developer Key for your account. Under the Details column, copy the number above the Show Key button and the key that is in the pop-up when you click Show Key. 
10. Send the number above Show Key, the Dev Key, and the school’s Canvas URL to Perceivant.
11. Make sure to turn the key ON.
12. Once the info is received by Perceivant, we will provide an authorization url for the Canvas admin to authorize the use of the developer key. We will also send the key and secret we generate for you to use to set up the external tools in the next step.