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.
Get delta educationClass collection Get incremental changes for educationClasses.


Property Type Description
classCode String Class code used by the school to identify the class.
createdBy identitySet Entity who created the class
description String Description of the class.
displayName String Name of the class.
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.
externalName String Name of the class in the syncing system.
grade String Grade level of the class.
id String Object identifier. Inherited from entity.
mailNickname String Mail name for sending email to all members, if this is enabled.
term educationTerm Term for this class.


Relationship Type Description
assignments educationAssignment collection All assignments associated with this class. Nullable.
assignmentCategories educationCategory collection All categories associated with this class. Nullable.
assignmentDefaults educationAssignmentDefaults collection Specifies class-level defaults respected by new assignments created in the class.
assignmentSettings educationAssignmentSettings collection Specifies class-level assignments settings.
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",
  "description": "String",
  "displayName": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  "classCode": "String",
  "externalName": "String",
  "externalId": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "grade": "String",
  "id": "String (identifier)",
  "mailNickname": "String",
  "term": {
    "@odata.type": "microsoft.graph.educationTerm"