Provision a Microsoft Teams class team from an existing Microsoft Graph educationClass

domain: education · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create the class first via POST /education/classes, which requires the application permission EduRoster.ReadWrite.All (no delegated permission is available for this operation) and automatically creates the backing Microsoft 365 group with education-specific properties.
  2. Allow time for the new group to finish provisioning before teamifying it — attempting to create the team too soon can return a 404.
  3. Call POST /teams with a body setting template@odata.bind to https://graph.microsoft.com/v1.0/teamsTemplates('educationClass') and group@odata.bind to the class's group ID.
  4. Do not include displayName, visibility, specialization, or members@odata.bind in that same request — those are inherited from the existing group/class, and combining them with group@odata.bind causes an error.
  5. POST /teams returns 202 Accepted with a teamsAsyncOperation link; poll that operation to confirm the team finished provisioning, retrying the POST after a short delay if you hit the early 404.

Known gotchas

Related routes

Create and publish an assignment for a class using the Microsoft Graph education API.
learn.microsoft.com · 5 steps · unrated
Retrieve school, class, and user roster data via Microsoft Graph education API resources
education · 5 steps · unrated
Create a Microsoft Teams online meeting attached to a Microsoft Graph calendar event
learn.microsoft.com · 5 steps · unrated

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?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans