educationClass resource type

Namespace: microsoft.graph

Represents a class within a school. The educationClass resource corresponds to the Microsoft 365 group and shares the same ID. Students are regular members of the class, and teachers are owners and have appropriate rights. For Office experiences to work correctly, teachers must be members of both the teachers and members collections.

Inherits from entity.


Method Return type Description
List educationClasses educationClass collection Get a list of the educationClass objects and their properties.
Create educationClass educationClass Create a new educationClass object.
Get educationClass educationClass Read the properties and relationships of an educationClass object.
Update educationClass educationClass Update the properties of an educationClass object.
Delete educationClass None Delete an educationClass object.
delta educationClass collection Get incremental changes to the resource collection.


Property Type Description
id String Object identifier. Inherited from entity.
displayName String Name of the class.
mailNickname String Mail name for sending email to all members, if this is enabled.
description String Description of the class.
createdBy identitySet Entity who created the class
classCode String Class code used by the school to identify the class.
externalName String Name of the class in the syncing system.
externalId String ID of the class from the syncing system.
externalSource educationExternalSource How this class was created. Possible values are: sis, manual.
externalSourceDetail String The name of the external source this resources was generated from.
grade String Grade level of the class.
term educationTerm Term for this class.


Relationship Type Description
group group The underlying Microsoft 365 group object.
members educationUser collection All users in the class. Nullable.
schools educationSchool collection All schools that this class is associated with. Nullable.
teachers educationUser collection All teachers in the class. Nullable.

JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.educationClass",
  "id": "String (identifier)",
  "displayName": "String",
  "mailNickname": "String",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  "classCode": "String",
  "externalName": "String",
  "externalId": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "grade": "String",
  "term": {
    "@odata.type": "microsoft.graph.educationTerm"