Clever Integration Types
Integration Options with Clever
When setting up your integration with Clever, you have three options:
- District Single Sign-On (SSO) integrations are managed by district administrators. Your application can be added through the Request Application page of the district dashboard. This integration facilitates SSO for any Clever user scoped by a district administrator. To learn more, see the District SSO Certification Guide.
- Rostering (Secure Sync) integrations are also managed by district administrators. Your application can be added through the Request Application page of the district dashboard. This integration allows you to pull district, school, user, and enrollment data via the Clever API, provided the district shares the data. To learn more, see the Secure Sync Certification Guide.
- Clever Library SSO and Rostering integrations are teacher-initiated. Teachers add your application through the Clever Library and can provision accounts on-demand for themselves and their students. To learn more, see the Library Certification Guide.
Development App Scopes
By default, your Clever development app will have Library (Classroom) scopes in addition to District SSO scopes. For rostering scopes, contact [email protected].
Integration Differences
![Clever App Options](https://files.readme.io/2bff516-Clever-App-Options-for-App-Partners-3_1.png)
District Rostering and SSO
Secure Sync allows you to access user information and provision accounts in advance, optimizing your core product. For Secure Sync access, contact [email protected].
District Integration Experience
District administrators can search for your application in the district dashboard and scope access to all users within the district. With a district-level integration, your application can be scoped to all users who need access within a district. Once data is shared, all scoped users' data will be available via the district-app token, allowing you to roster and provision accounts at scale.
User Login Methods
- Clever Portal: Primary launch point for many districts into their applications.
- Instant Login Links: Embedded links used to log a district's users into a specific application through Instant Login.
- Log In With Clever: "Log in with Clever" buttons embedded on your website for direct user authentication.
Data Shared via Secure Sync
Secure Sync provides full access to roster information, including student-teacher associations and classroom-level data. OAuth tokens can be retrieved from your App Dashboard or via our API. Upgrading to District Certification allows access to the entire Data API, matchmaking tools, Data Browser, and more. Refer to our schema for a full list of available fields in Clever.
Available Fields
For a detailed list of available fields in each integration type, see the Clever API Schema.
Working with Districts
Learn how applications connect with districts:
Library (Classroom) Rostering and SSO
Library Integration Experience
When a teacher clicks on a new app in the Clever Library or the ‘Sign Up with Clever’ button, they see a consent screen to authorize Clever to share their section (class) data with the app. After authorization, Clever redirects the teacher to your app, and you facilitate the OAuth Single Sign-On flow using API calls to query the user’s identity and classroom information. The teacher’s account is provisioned immediately, and they are logged in to a free or freemium experience with their section and student data populated. The app is added to the Clever Portal for the teacher and their shared students, allowing student logins as well.
Teacher Sign-Up Entry Points
- Teachers finding you through the Clever Library and clicking “Install”.
- Teachers clicking the “Sign Up with Clever” button on your website’s teacher signup page.
Data Shared Upon Teacher Consent
Teacher Object Data
- Clever ID (unique and stable ID created by Clever)
- Name (first, middle, last)
Teacher’s Shared Sections
- Clever ID
- Name
- Section number
- Teachers
- Students
- Subject (normalized to a set of possible values)
- Grade (if available from the SIS)
Student Object Data in Those Sections
- Clever ID (a GUID generated by Clever)
- Name
- Grade (if available from the SIS)
Accessing District and School Data
You cannot access District or School level data with default Library (Classroom) scopes. Contact [email protected] to gain access.
Working with Teachers
Learn how applications connect with teachers:
Updated 10 days ago