ESC
Type to search...

TeamworkCustomEmoji.Read

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Read custom emoji on behalf of the signed-in user.

In short

TeamworkCustomEmoji.Read is a delegated permission in the Microsoft Graph API, grouped under the TeamworkCustomEmoji category. Read custom emoji on behalf of the signed-in user. It grants read-only access to resources. Users can consent to this permission during sign-in.

Permission data: November 17, 2026 at 3:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Read custom emoji

Read custom emoji on behalf of the signed-in user.

Properties

Microsoft Graph beta exact-category-docs

Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Property Type Description
contentBytes BinaryNullable The base64-encoded image content of the emoji. Supported formats include PNG and GIF. Inherited from teamworkHostedContent.
contentType StringNullable The media type of the custom emoji content, such as image/png or image/gif. Inherited from teamworkHostedContent.
createdBy customEmojiFromIdentitySet Identity of the user who created the emoji.
createdDateTime DateTimeOffset The date and time when the emoji was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
displayName String The unique display name of the custom emoji. This property is an alternate key and must not conflict with existing emoji names.
id String The service-generated identifier of the custom emoji. Inherited from teamworkHostedContent.

JSON Representation

Microsoft Graph beta exact-category-docs

JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

JSON representation
{
  "@odata.type": "#microsoft.graph.teamworkCustomEmoji",
  "id": "String (identifier)",
  "contentBytes": "Binary",
  "contentType": "String",
  "displayName": "String",
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.customEmojiFromIdentitySet"
  }
}

Relationships

Microsoft Graph beta schema-derived

Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Relationship Type Description
createdBy customEmojiFromIdentitySet Related createdBy data exposed by this resource.

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.

No API methods available for this version.

Exact Microsoft Learn match

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

Methods
GET /teamwork/messaging/customEmojis
GET /teamwork/messaging/customEmojis/{displayName}
GET /teamwork/messaging/customEmojis/{displayName}/$value
Exact Microsoft Learn PowerShell match

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

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaTeamworkMessagingCustomEmoji /teamwork/messaging/customEmojis
List customEmojis

Code Examples

C# / .NET SDK
List customEmojis
// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teamwork.Messaging.CustomEmojis.GetAsync();
JavaScript
List customEmojis
const options = {
	authProvider,
};

const client = Client.init(options);

let customEmojis = await client.api('/teamwork/messaging/customEmojis')
	.version('beta')
	.get();
PowerShell
List customEmojis
Import-Module Microsoft.Graph.Beta.Teams

Get-MgBetaTeamworkMessagingCustomEmoji
Python
List customEmojis
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.teamwork.messaging.custom_emojis.get()

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 Delegated permissions and search for TeamworkCustomEmoji.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.

Frequently asked questions

What is the TeamworkCustomEmoji.Read Microsoft Graph permission?

TeamworkCustomEmoji.Read is a delegated permission in the Microsoft Graph API, grouped under the TeamworkCustomEmoji category. Read custom emoji on behalf of the signed-in user. It grants read-only access to resources. Users can consent to this permission during sign-in. It is mapped to the Microsoft Graph teamworkcustomemoji resource type. 3 documented Microsoft Graph REST methods require it. 1 Microsoft Graph PowerShell command is documented for it.

Is TeamworkCustomEmoji.Read an application or a delegated permission?

TeamworkCustomEmoji.Read is a delegated permission only. It grants access on behalf of a signed-in user and cannot be used for app-only access.

Does TeamworkCustomEmoji.Read require admin consent?

Users can consent to this permission during sign-in.

What is the permission ID (GUID) for TeamworkCustomEmoji.Read?

For TeamworkCustomEmoji.Read, the delegated (OAuth2 scope) ID is 89b231b1-414e-4dd4-bb87-d59906da4e05. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.