Member.Read.Hidden | Graph Permissions

Permission Details

Application Permission

Read all hidden memberships

Allows the app to read the memberships of hidden groups and administrative units without a signed-in user.

Permission ID: 658aa5d8-239f-45c4-aa12-864f4fc7e490

Delegated Permission

Read hidden memberships

Allows the app to read the memberships of hidden groups and administrative units on behalf of the signed-in user, for those hidden groups and administrative units that the signed-in user has access to.

Permission ID: f6a3db3e-f7e8-4ed2-a414-557c8c9830be

Properties

Microsoft Graph v1.0 endpoint-derived-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`classCode`	`String`Nullable	Class code used by the school to identify the class.
`createdBy`	`identitySet`	Entity who created the class
`description`	`String`Nullable	Description of the class.
`displayName`	`String`	Name of the class.
`externalId`	`String`Nullable	ID of the class from the syncing system.
`externalSource`	`educationExternalSource`	How this class was created. The possible values are: sis, manual.
`externalSourceDetail`	`String`Nullable	The name of the external source this resource was generated from.
`externalName`	`String`Nullable	Name of the class in the syncing system.
`grade`	`String`Nullable	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.
`assignmentCategories`	`educationCategory collection`	All categories associated with this class. Nullable.
`assignmentDefaults`	`object`	Specifies class-level defaults respected by new assignments created in the class.
`assignments`	`educationAssignment collection`	All assignments associated with this class. Nullable.

Showing 15 of 22 properties.

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "@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"
  }
}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

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.
`modules`	`[educationModule] collection`	All modules 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.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/education/classes/{id}/members`
POST `/education/classes/{id}/members/$ref`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/education/classes/{id}/members`
POST `/education/classes/{id}/members/$ref`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgEducationClassMember` /education/classes/{id}/members List members of an educationClass
`New-MgEducationClassMemberByRef` /education/classes/{id}/members/$ref Add a student

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaEducationClassMember` /education/classes/{id}/members List members
`New-MgBetaEducationClassMemberByRef` /education/classes/{id}/members/$ref Add a student

Code Examples

C# / .NET SDK

Add a student

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new ReferenceCreate
{
	OdataId = "https://graph.microsoft.com/v1.0/education/users/13015",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Education.Classes["{educationClass-id}"].Members.Ref.PostAsync(requestBody);

JavaScript

Add a student

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const educationUser = {
  '@odata.id':'https://graph.microsoft.com/v1.0/education/users/13015'
};

await client.api('/education/classes/{class-id}/members/$ref')
	.post(educationUser);

PowerShell

Add a student

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Education

$params = @{
	"@odata.id" = "https://graph.microsoft.com/v1.0/education/users/13015"
}

New-MgEducationClassMemberByRef -EducationClassId $educationClassId -BodyParameter $params

Python

Add a student

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.reference_create import ReferenceCreate
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ReferenceCreate(
	odata_id = "https://graph.microsoft.com/v1.0/education/users/13015",
)

await graph_client.education.classes.by_education_class_id('educationClass-id').members.ref.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for Member.Read.Hidden

4

Grant Admin Consent

Application permissions always require admin consent.