☝️

Please Note

The Clever Library integration can only exist for a user if there is no district-level integration. Similarly, if a user belongs to a district that is connected with your application, that district-level connection will take precedence over the Clever Library connection. There are workarounds to this, though. If you're interested in exploring these concepts, please reach out to [email protected].

Introduction

The Clever Library integration is initiated at the classroom level, meaning teachers can explore the Clever Library and add Clever Library applications for themselves as well as the students they teach. This gives you an opportunity to get your product directly into the hands of teachers and students!

Check out the Clever Library here! If you're curious about how teachers and districts interact with the Clever Library, you can take a look at this Help Center article

📘

Not sure if you're in the right place?

This page describes specifics on the Clever Library integration. If you are looking for an overview of how Clever Single Sign-On works, see https://dev.clever.com/docs/sso-overview.

Clever Library integration will work for your application if:

• You have an existing user registration/signup flow.
  • The Clever Library authorization flow can be seamlessly integrated into your registration steps, automating most of the field entry and creating a one-step (or near one-step) sign-up process.
• You have a way for teachers to create classes with rosters in your application and to provision accounts for their students.
  • This functionality would fit perfectly with the Clever Library use case. You would just need to introduce an option to "Sync Classes via Clever". You could also choose to do this automatically!
• Your application can authenticate users based on limited information. Please note that student email is not available with this integration type.
  • You can refer to https://clever.com/schema to see which fields you have access to with the Clever Library integration type
• You sell your product directly to teachers.
  • If you sell to districts or schools, the Clever Library integration might not be a good fit for you since Clever Library is considered a "bottoms-up" integration where the teachers are authorizing connections instead of district administrators.
• You have a student experience.
  • Apps in the Clever Library are usually geared towards the classroom experience. While it is not a requirement to serve teachers and students, it is certainly an expectation with apps in the Clever Library.
  • Please note that admins do not have access to Clever Library integrations.

📘

Clever Library integrations must be free-ish!

Please note that it is a requirement for Clever Library integrations to offer a free trial, demo, or freemium access.

What features are available with Clever Library?

Testing Suite and Integration Guide

For the Clever Library integration, you will find an Integration Guide along with a step-by-step testing wizard in your developer dashboard that allows you to quickly validate your integration.

Marketing Collateral

As part of your Clever Library application listing, you'll have the opportunity to include some marketing collateral, including screenshots of your product. Please note that this marketing collateral is a requirement for Clever Library Certification.

• A Clever Library page that includes marketing collateral and teacher reviews. Check out the Clever Library here to see what this looks like.

Dashboard

• As a Clever application, you will be granted a developer dashboard where you can access basic SSO settings, credentials, and application profile description fields.
• You will not have access to SSO troubleshooting tools
  • With this access tier, you will not have the ability to troubleshoot SSO issues for production users through your dashboard. If you need assistance with troubleshooting for your users, you can rely on the Clever support team at https://support.clever.com.

Scopes and Field Access

One benefit of the Clever Library integration is that you can receive rostering data free of cost, albeit in a limited capacity. This means, as long as the teacher has authorized the connection, you will receive access to the following:

• teacher first name, last name, email address, and Clever ID
• all sections associated with the teacher
• section names, subjects, and grades
• all students associated with a teacher
• student first name, last initial, and grade

🚧

Do you require emails?

Student email address is NOT available through the Clever Library integration. If this is a requirement for your application, one workaround is to prompt students to provide their email addresses upon the first login.

How much does it cost?

• The Clever Library integration is free of cost.