Teams Creation via API: Class Home page issue

Question

Dear all,

in our education environment, we have set up that from our school management program, Teams in MS are being created automatically, programatically via MS Graph API.

It works all well and good with all, except the class home page. When I first open the team and go to the home page tab, it just displays the general sharepoint home page of my tenant, and not the class specific one.

Only when I click around MS Teams a bit and return to the tab after some time, the option appears and the ClassHome gets generated.

I was wondering if someone has/had the similar problem and if you know any possible solutions to this issue.

Thanks.

Best regards
[Moderator note: personal info removed]

Answer 1

Please note that Q&A forum is a public platform, and moderators will modify the question to hide personal information in the description. Kindly ensure that you hide any personal or organizational information the next time you post an error or other details to protect personal data.

Hi @Daniel DSHAJANI   

Unfortunately, I don’t have access to an education license, so I’m not able to reproduce the same scenario on my side. I did spend some time researching this behavior, but so far, I haven’t come across any similar cases that have been reported 

To help determine whether this behavior is related to a provisioning delay, you may consider creating another class team for validation. Using Microsoft Teams PowerShell is generally the recommended approach, with Microsoft Graph PowerShell available as an alternative option. Microsoft also provides a helpful guide in Provisioning classes at scale using PowerShell and Microsoft Graph - Microsoft Support 

For additional insight, I also recommend reaching out to the Home | Microsoft Community Hub or community · Discussions · GitHub. These platforms are great places to connect with others who may have encountered similar scenarios and are willing to share their experiences. 

I apologize for the limitations on my side, but I hope this information still provides some helpful direction.

---

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

Answer 2

Class home pages are created and managed by the Teams for Education experience and its underlying SharePoint site. When a class team is created programmatically via Microsoft Graph, the team and its SharePoint site are provisioned, but the class-specific home page template is not guaranteed to be applied immediately on first open.

Behavior from the product documentation:

• Every class team has a Home page tab that is a SharePoint page.
• The first time the Home page is opened, Teams either:
  • Uses the class home page template, or
  • If a SharePoint page already exists for that team’s site, prompts to choose between the existing page and the class home page template. Selecting the class home page overwrites the existing page.
• Only educators can publish changes to the class home page, and editing is only supported in the desktop/web client, not mobile.

In an automated/Graph-created scenario, this leads to:

• The underlying SharePoint site may initially show its default home page (what is being seen as the “general SharePoint home page”).
• The class home page template is applied only after Teams has fully recognized the team as a class team and the educator first interacts with the Home page tab. This can appear as a delay where the generic page shows first, and only later the option to switch to the class home page appears.

Mitigation/operational guidance based on the documented behavior:

1. Ensure that teams created via Graph are actually class teams (education/class type) so that the class home page feature applies.
2. After creation, expect a delay before the class home page template becomes available; the first educator visit to the Home page may still show the default SharePoint page until Teams completes its background setup.
3. When the dialog appears offering to use the class home page template vs. the existing page, choosing the class home page will overwrite the default SharePoint home page and give the expected class-specific layout (announcements, pinned resources, assignments, etc.).
4. Once the class home page is in place, educators can customize it using SharePoint web parts as needed.

There is no additional documented API or setting in the provided material to force immediate class home page generation at the moment of team creation; the behavior is tied to the Teams/SharePoint provisioning flow and first-use experience.

---

References:

• Set up a home page in your class team
• Microsoft Education FAQ for IT admins
• Get started with Microsoft Teams for remote learning