---
title: "POST /v1/customEmojis"
method: POST
path: "/v1/customEmojis"
tags: ["customEmojis"]
---

# POST /v1/customEmojis

`POST /v1/customEmojis`

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](https://support.google.com/chat/answer/12800149) and [Manage custom emoji permissions](https://support.google.com/a/answer/12850085). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.customemojis`

## Request body

- CustomEmoji — Represents a [custom emoji](https://support.google.com/chat/answer/12800149).
  - `uid` string — Output only. Unique key for the custom emoji resource.
  - `temporaryImageUri` string — 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.
  - `name` string — Identifier. The resource name of the custom emoji, assigned by the server. Format: `customEmojis/{customEmoji}`
  - `emojiName` string — 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:`
  - `payload` CustomEmojiPayload — Payload data for the custom emoji.
    - `fileContent` string, byte — Required. Input only. The image used for the custom emoji. The payload must be under 256 KB and the dimension of the image must be square and between 64 and 500 pixels. The restrictions are subject to change.
    - `filename` string — Required. Input only. The image file name. Supported file extensions: `.png`, `.jpg`, `.gif`.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/chat.md) · [All operations](https://skmtc.net/google/apis/chat/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/chat/versions/a57a778f1fcb/schema)