Sync school and roster data into Microsoft 365 for Education using School Data Sync (SDS) v2.1 CSV files
domain: education · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Prepare the SDS v2.1 CSV file set: orgs.csv, users.csv, and roles.csv are always required; add classes.csv and enrollments.csv only if you are also managing classes/enrollments.
Include optional files only as needed: academicSessions.csv, courses.csv, demographics.csv, userFlags.csv, and relationships.csv (guardian/contact relationships).
In the SDS admin portal, create or edit a sync profile, set Source Format to CSV and Format Version to "SDS v2.1 CSV", then upload the file set through the manual upload flow (or automate periodic uploads with Power Automate).
Let the sync profile provision and update Microsoft 365 groups, class teams, and user accounts from the ingested roster data on each successful sync.
Known gotchas
SDS v2.1 uses this OneRoster-style CSV schema (orgs.csv, users.csv, roles.csv, classes.csv, enrollments.csv) — a different, newer file set than the older SDS v1 flat-file names; don't mix the two formats.
CSV filenames and column headers are case-sensitive and must match exactly or the upload is rejected.
Each sync upload must include the complete set of previously supplied files, not just the changed ones — omitting an optional file you supplied before causes SDS to treat its records as deactivated.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?