GuidesClever App DashboardAPI Postman CollectionClever AcademySupportStatus
Guides

Clever Integration Types

Clever Integration Options

The following are the different integration types you can build with Clever:

Rostering (Secure Sync)

  • Secure Sync delivers comprehensive roster data, including student demographics and enrollment information, ensuring accurate and up-to-date records as changes are received from the district SIS. By providing structured user and role data, it simplifies integration for downstream systems, helping organizations manage access, personalize experiences, and maintain data consistency. For Secure Sync access, reach out to [email protected].
  • Managed by district administrators.
  • Your application can be added through the Request Application page on the district dashboard. To learn more, see Getting Started in the District.

LMS Connect

  • Managed by district administrators. This integration type requires a Secure Sync subscription.
  • Districts can request to connect to your application via LMS Connect. This integration enhances your Secure Sync integration and allows assignment and grade passback with the most popular K12 LMSs.
    To learn more, see LMS Connect - Overview.

District Single Sign-On (SSO)

  • Managed by district administrators.
  • Your application can be added through the Request Application page on the district dashboard. This integration allows district administrators to scope SSO access to any Clever user within their district.
    To learn more, see District SSO.

Clever Library SSO and Rostering

Integration Diagram

📘

Development App Scopes

By default, your Clever development app will include Library (Classroom) and District SSO scopes. To request Rostering and LMS Connect scopes, contact [email protected].

District vs Library (Classroom) Integrations

District Integration Experience

District administrators can search for and add your application in the district dashboard, granting access to all users within the district. Once a district shares data, all users within the district who are scoped for access can have their data available via the district-app token, enabling you to manage rostering and account provisioning at scale.

District SSO User Login Methods

  1. Clever Portal
    A central point for many districts to access their applications.

  2. Instant Login Links
    Use embedded links to log users directly into your app through Instant Login.

  3. Log In with Clever
    Embed a "Log in with Clever" button on your website for direct user authentication.

Data Shared via District SSO

  • Clever ID (unique and stable ID created by Clever)
  • Full Name (first, last)
  • Email Address
  • District

Data Shared via Secure Sync

While District SSO only provides name, email address, and Clever ID for a user, 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 Clever API. A Secure Sync subscription grants access to the entire Data API, as well as a suite of developer tooling that comes in handy for managing your district connections. For the full list of available fields, see our schema.

Data Shared via LMS Connect

The LMS Connect integration extends your existing rostering and enrollment data to provide LTI capabilities such as grade passback and LTI SSO. With this integration, you can create assignments and submit grades directly to a district’s LMS. You can also track updates to the assignments and submissions made through LMS Connect, but you won’t have access to assignments or submissions created outside of this integration."

📘

Available Fields

For a detailed list of fields available for each integration type, check the Clever API Schema.

📘

Working with Districts

Learn how applications connect with districts:

Library (Classroom) Integration Experience

When a teacher selects a new app from the Clever Library or clicks "Sign Up with Clever," they are presented with a consent screen to authorize Clever to share their class data with your app. After consent, Clever redirects the teacher to your app, where you facilitate the OAuth Single Sign-On flow to query user identity and classroom information. The teacher's account is provisioned immediately, and their section and student data is populated, providing a seamless login experience. The app will also be available in the Clever Portal for the teacher and their students.

Teacher Sign-Up Entry Points

  1. Teachers discover your app via the Clever Library and click "Install."
  2. Teachers click the "Sign Up with Clever" button on your website's teacher sign-up page.

Data Shared Upon Teacher Consent

Teacher Object Data

  • Clever ID (unique and stable ID created by Clever)
  • Full Name (first, middle, last)
  • Email Address

Teacher’s Shared Sections

  • Clever ID
  • Section Name
  • Section Number
  • Teachers
  • Students
  • Subject (normalized to a set of possible values)
  • Grade (if available from the SIS)

Student Object Data in Shared Sections

  • Clever ID (a GUID generated by Clever)
  • Name
  • Grade (if available from the SIS)

❗️

Accessing District and School Data

Default Library (Classroom) scopes do not provide access to District or School-level data. To access this data, contact [email protected].

📘

Working with Teachers

Learn how applications connect with teachers:

Updated 7 days ago

What’s Next