Class Notebook not working when creating new Teams

Valerie Brown 51 Reputation points
2025-06-25T15:59:08.4166667+00:00

Hi, I've got a problem with new teams being created, which have a class notebook that doesn't work. When trying to create a new blank class notebook I get a message saying 'something went wrong', and the option to retry. Every time I click retry, I get the same message. It's happened with quite a few teams now. How can I fix the issue, can you help?

Microsoft Teams | Development
{count} votes

Accepted answer
  1. Sjoerd Derks 76 Reputation points
    2025-08-19T14:46:06.46+00:00

    We encountered the same issue when creating Teams. The Notebook app fails to launch, and it seems something has changed on Microsoft's side regarding how Teams are provisioned.

    Previously, we created a group first and then promoted it to a Team using an Edu_C template. However, when we now create a new Team this way, the Notebook throws an error.

    Old Method (Group → Team)

    # Create Group
    $params = @{
        displayName = $name
        mailNickname = $name
        description = $name
        groupTypes = @("Unified")
        mailEnabled = $true
        securityEnabled = $false
        visibility = "HiddenMembership"
        creationOptions = @("ExchangeProvisioningFlags:461", "classAssignments")
        extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType = "Section"
    }
    
    # $Newgroup = New-MgGroup -BodyParameter $params
    $groupResponse  = Invoke-MgGraphRequest -Method POST -Uri "https://graph.microsoft.com/v1.0/groups" -Body $params
    $groupId = $groupResponse.id
    

    New Working Method (Create Class → Promote to Team)

    Instead of creating a group first, you now need to create an Education Class. Once you promote this class to a Team, the Notebook works correctly.

    # Payload for education class
    $params = @{
        displayName     = $name
        mailNickname    = $name
        description     = "$name class group"
        classCode       = "BIO101"
        externalId      = "BIO101-3558"
        externalName    = $name
        externalSource  = "sis"
    } | ConvertTo-Json -Depth 10
    
    # Call to beta endpoint
    $groupResponse = Invoke-MgGraphRequest -Method POST -Uri "https://graph.microsoft.com/beta/education/classes" -Body $params
    
    

    This new method is only useful for future provisioning. Luckily, existing groups can still be repaired.

    Fix for Existing Groups

    The EDU OneNote app needs permissions on the underlying SharePoint site. Reference:
    https://support.microsoft.com/en-us/topic/provisioning-class-notebooks-and-sites-at-scale-using-microsoft-graph-apis-cd9dc583-fd1b-4ee3-ac21-d585b0802db0

    I created a little script to automate this fix: (Use at own risk)

    
    #Connect to Microsoft Graph
    Connect-MgGraph -Scopes "Sites.FullControl.All","Group.Read.All","User.Read.All"
    
    
    #Add Temp Owner
    $user = Get-MgUser -UserId "******@school.nl"
    $ownerId = $user.Id  
    
    #Get all the Groups
    $AllTeams = Get-MgTeam -All
    
    #Specify the Teams to Repair. 
    $Repair = $allTeams | Where-Object { $_.DisplayName -like "25-26*" }
    
    #Add Owner
    ForEach ($R in $Repair) {
    
      #Set the Owner
      #Owner 
      $newGroupOwner =@{
        "@odata.id"= "https://graph.microsoft.com/v1.0/users/{$ownerId}"
        }
    
    Write-Host Set $user.DisplayName as Owner for $($R.DisplayName)
    
      #Add the Owner
      $groupId = $R.Id
      New-MgGroupOwnerByRef -GroupId $groupId -BodyParameter $newGroupOwner -ErrorAction SilentlyContinue
    }
    
    
    
    # EDU service app IDs waarvoor de site FullControl nodig heeft
    $eduApps = @(
        @{ id = "22d27567-b3f0-4dc2-9ec2-46ed368ba538"; name = "EDU Teams Assignment" },
        @{ id = "c9a559d2-7aab-4f13-a6ed-e7e9c52aec87"; name = "EDU Teams Notebook" },
        @{ id = "13291f5a-59ac-4c59-b0fa-d1632e8f3292"; name = "EDU OneNote" },
        @{ id = "2d4d3d8e-2be3-4bef-9f87-7875a61c29de"; name = "EDU Teams Files" },
        @{ id = "8f348934-64be-4bb2-bc16-c54c96789f43"; name = "EDU Teams Calendar" }
    )
    
    
    
    # Fix the site and  the Remove Owner
    ForEach ($R in $Repair) {
    
    #Get the Site ID
    $groupid = $R.Id
    $site = Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/groups/$groupId/sites/root"
    $site.id
    
    #Loop the apps
    ForEach ($app in $eduApps) {
            $body = @{
                roles = @("fullcontrol")
                grantedToIdentities = @(@{
                    application = @{
                        id = $app.id
                        displayName = $app.name
                    }
                })
            }
          
        
    Write-Host "Reset permissions for $($app.name) on $($R.DisplayName)" -ForegroundColor Cyan
    Invoke-MgGraphRequest -Method POST -Uri "https://graph.microsoft.com/v1.0/sites/$($site.id)/permissions" -Body $body
          }
    
    #Remove the Owner
    Write-Host Remove $user.DisplayName as Owner for $($R.DisplayName)
    Remove-MgGroupOwnerByRef -GroupId $groupId -DirectoryObjectId $ownerId -ErrorAction SilentlyContinue
    
        }
    
    
    

    EDIT: I've updated the script due to issues we've encountered with file uploads in Assignments. It appears we also need to include the following apps to ensure proper functionality:

    @{ id = "22d27567-b3f0-4dc2-9ec2-46ed368ba538"; name = "EDU Teams Assignment" },
    @{ id = "c9a559d2-7aab-4f13-a6ed-e7e9c52aec87"; name = "EDU Teams Notebook" },
    @{ id = "13291f5a-59ac-4c59-b0fa-d1632e8f3292"; name = "EDU OneNote" },
    @{ id = "2d4d3d8e-2be3-4bef-9f87-7875a61c29de"; name = "EDU Teams Files" },
    @{ id = "8f348934-64be-4bb2-bc16-c54c96789f43"; name = "EDU Teams Calendar" }
    
    

6 additional answers

Sort by: Most helpful
  1. Jäger Sven 5 Reputation points
    2025-07-07T11:55:37.8766667+00:00

    Hello Valerie, Chris, Keith and Microsoft,

    we are facing the exactly same issue where in our Teams created as classes with the Education Template we can not create a "Class Notebook". First we thought this was tied to the Team needing to be manually activated before Students can see something but also after activating the Team the issue still persists and the OneNote class notebook can not be created just stating "Something went wrong".

    What I found out during testing is the fact that in our Tenant this behaviour is only for the Teams that I created using PowerShell (as we have 100+ Teams that need to be created)

    When I manually create a "Class" Team in MS Teams I can add the Class Notebook without a problem.

    Therefore I think that something is broken when creating Teams via PowerShell or GraphAPI.

    As we have created our Teams via PowerShell for 1,5+ years and have 1700+ Teams in place that are working fine this problem must have come with one of the last updates to MS Teams.

    If someone finds a better way than manually creating all the Teams I need for the new semester please put the solution in here ;)

    Please Microsoft help us as our teachers are getting very frustrated and upset :/

    Thanks in advance,

    Sven

    1 person found this answer helpful.

  2. Dora-T 4,105 Reputation points Microsoft External Staff Moderator
    2025-06-26T02:49:43.3533333+00:00

    Hi @Valerie Brown

    Welcome to Microsoft Q&A Forum. 

    I know how discouraging it can be when a feature doesn’t behave the way it should, particularly when it impacts several teams at once. 

    I have tested this feature in my own environment, and it appears to be working normally, so I would like to suggest a few steps that may help resolve the issue on your side: 

    1.Check the team type: 

    Class Notebook is designed specifically for class teams, and it may not function properly with other types like "Staff" or "Other".  

    You can find more information about selecting the correct team type here: 

    Choose a team type to collaborate in Microsoft Teams - Microsoft Support 

    2.Try using Teams on the web: 

    Go to https://teams.microsoft.com, sign in, and access your class team there. Sometimes the web version works better for certain setup steps. 

    3.Create the notebook manually: 

    After creating it, copy the notebook link. 

    User's image

    Then go to your team, select Add a tab > choose OneNote > paste the link > click Save.

    User's image

    User's image

    User's image

    User's image

    User's image

    Please note that after pasting the link, it may take a few moments for the notebook to fully load and appear in the tab. If it doesn’t show up immediately, give it a little time and try refreshing the tab if needed. 

    I hope this helps. If the issue continues, feel free to share more details and I’ll be happy to assist further.


    If the answer is partially helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".       

    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.


  3. Chris Smithson 0 Reputation points
    2025-07-01T17:40:30.3933333+00:00

    I have been having the same issue with dozens of our newly created Class Teams, so its definately not just your Tennant Valerie. So far MS Support haven't come up with anything that points to the cause, or resolution.

    Some of the Teams that did have the issue, have since rectified themselves, but most haven't. The ones with the issue also have a problem with attaching files to Assignments, which possibly points to a permissions issue in the backend even though everything appears to be ok.

    I really wish MS would come up with a solution as my teachers are starting to lose patience with it.

    Lastly, manually creating a Class OneNote is not a suitable solution, as it wouldn't be kept upto date with class changes via MIS / SDS.


  4. Chris Smithson 0 Reputation points
    2025-07-07T20:16:49.23+00:00

    After a lot of back and forth with Microsoft Support they got one of the affected Class Teams OneNotes working by running something against the Team in the back end. I have since sent the rest of the ~ 30 affected Teams which they are working on (hopefully now). The Support Engineer said that it was only something they could run so I can't be of any more help, other than to suggest to raise a ticket and push for them to fix it in the back end.


Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.