Blackboard Admin Setup

If you are planning to conduct testing, we welcome you to do so in our testing environment, staging.perusall.com.  Staging is only for testing and should not contain any real course or student data.  See Notes below for more information.

Disclaimer: Data on staging may be removed at any time.
 

Step 1: Install Perusall 1.3

1. Navigate to System Admin > Integrations > LTI Tool Providers, and select Register LTI 1.3/Advantage Tool.
2. For Client ID, enter fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6 and click Submit For staging, use 2639a1cf-9230-4441-aae8-701c7414e145.
3. Take note of the Deployment ID that is shown in the next screen.
4. Ensure the tool is Approved, and under Institution Policies, ensure Role in Course, Name, and Email Address are all checked, and that both grade access service and Membership Service Access are set to Yes. Then click Submit.
5. Select Manage placements, and ensure that the deep link placement is set to open in a new window.
6. Navigate to System Admin > System Roles > Create a Role.
   • Name: Perusall API
   • Role ID: perusallapi
   • Description: This is the user that Perusall will act as when accessing group information for your courses.
   • Assign the following privileges:
     • Course/Organization > Groups > View All Groups
     • Course/Organization Control Panel (Users and Groups) > Groups
7. Navigate to System Admin > Users > Create User.
   • First Name: Perusall
   • Last Name: API
   • Username perusallapi
   • Password should be unique.  It's not an account that's ever going to be used to log in.
   • Primary Institution Role: Student
   • Primary System Role: Perusall API
8. Navigate to System Admin > Integrations > REST API Integrations, and select Create integration.
9. Enter the following values, and then click Submit.
   • Application ID: fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6
     If you're using staging, use 2639a1cf-9230-4441-aae8-701c7414e145.
   • Learn User: Perusall API
   • End User Access: Yes
   • Authorized To Act As User: No

Step 2: Add your LTI Platform through the Institution Dashboard

Please follow the steps below to finalize your integration by adding the Perusall LTI 1.3 tool information from your LMS to our list of LTI Platforms using your Institution Dashboard. 

• Register for an account.

• Contact Perusall support, and point us to an institutional web page that shows your name, email address and title/affiliation.

  If you are using staging.perusall.com, please register for a staging account, provide the verification details above, and when you contact Perusall support, please let us know you'd like access to the Staging institution dashboard.

• 

  Once Perusall has confirmed your request, you will see Institution Dashboard on your Perusall home page (to the left of Get Help), and you can navigate to Settings > LTI 1.3 integrations > Add a new LTI 1.3 integration.  Select your LMS type (Blackboard), and insert your Deployment ID.

• Click Ok to finalize your placement, and Save Changes.

Learn more about your Institution dashboard features.

Testing the integration

Once your credentials have been entered into our platform list, you can test the integration by following Blackboard Instructor Setup & Blackboard Integration Features.

LTI 1.3 courses offer a new grade sync feature: LMS gradebook column management.  Learn more about grade sync in LTI 1.3 courses. 

For a full list of frequently asked questions regarding our LTI 1.3 integrations, see 1.3 FAQ.

Please whitelist messages coming from @perusall.com and @mg.perusall.com to ensure users are able to receive our emails.