customEmojis

POST /v1/customEmojis

Changed on Oct 10, 2026

Creates a custom emoji. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see Learn about custom emojis in Google Chat and Manage custom emoji permissions. Requires user authentication with the authorization scope: - https://www.googleapis.com/auth/chat.customemojis

Request

Base URL
https://chat.googleapis.com
URL
https://chat.googleapis.com/v1/customEmojis
Auth
OAuth 2 and OAuth 2
Implicit: https://accounts.google.com/o/oauth2/auth
Scopes: https://www.googleapis.com/auth/chat.customemojis
Authorization code: https://accounts.google.com/o/oauth2/auth
Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/chat.customemojis

Request body

emojiNamestring

Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: :valid-emoji-name:

namestring

Identifier. The resource name of the custom emoji, assigned by the server. Format: customEmojis/{customEmoji}

temporaryImageUristring

Output only. A temporary image URL for the custom emoji, valid for at least 10 minutes. Note that this is not populated in the response when the custom emoji is created.

uidstring

Output only. Unique key for the custom emoji resource.

Response

Successful response