Roster an app via Clever Secure Sync

Steps

1. Create a Clever application in the Clever developer dashboard and configure it as a Secure Sync application; obtain your client_id and client_secret from the dashboard, and note your sandbox district bearer token for testing.
2. Authorize access to a district's data: the district connects your app via the Clever district dashboard, which generates a district-specific bearer token; in production, retrieve this token through the OAuth 2.0 authorization code flow at https://clever.com/oauth/authorize.
3. Call GET https://api.clever.com/v3.0/districts to verify your token is valid and retrieve the district object; the response identifies the district you have access to.
4. Fetch roster data using the typed endpoints: GET /v3.0/schools, /v3.0/sections, GET /v3.0/users?role=student (or teacher, staff, district_admin); all endpoints return paginated results with next links in the response.
5. Use the Events API (GET /v3.0/events) to retrieve incremental changes since your last sync timestamp; events describe created, updated, and deleted records and are available for the previous 30 days.
6. Sync your application's user and roster data by matching on Clever's stable id field; store the Clever id as your external identifier to support future delta syncs and event-based updates.