Method: customEmojis.create
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
POST https://chat.googleapis.com/v1/customEmojis
The URL uses gRPC Transcoding syntax.
Request body
The request body contains an instance of CustomEmoji.
Response body
If successful, the response body contains a newly created instance of CustomEmoji.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/chat.customemojis
For more information, see the Authorization guide.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.
[null,null,["Last updated 2025-05-07 UTC."],[[["\u003cp\u003eThis Developer Preview feature enables the creation of custom emojis in Google Chat.\u003c/p\u003e\n"],["\u003cp\u003eIt necessitates user authentication and uses the \u003ccode\u003echat.customemojis\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eThe feature functions through an HTTP POST request, utilizing gRPC Transcoding, and involves request and response bodies containing the \u003ccode\u003eCustomEmoji\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eTo explore its functionality, refer to the "Try it!" section within the documentation.\u003c/p\u003e\n"]]],["This document outlines how to create a custom emoji using the Google Chat API. A `POST` request to `https://chat.googleapis.com/v1/customEmojis` is required, with the request body containing `CustomEmoji` data. Successful requests return a new `CustomEmoji` instance in the response body. This action is available through the Google Workspace Developer Preview Program and requires user authentication and the `https://www.googleapis.com/auth/chat.customemojis` OAuth scope. The API uses gRPC Transcoding.\n"],null,["# Method: customEmojis.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a custom emoji.\n\nCustom 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).\n\nRequires [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):\n\n- `https://www.googleapis.com/auth/chat.customemojis`\n\n### HTTP request\n\n`POST https://chat.googleapis.com/v1/customEmojis`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [CustomEmoji](/workspace/chat/api/reference/rest/v1/customEmojis#CustomEmoji).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CustomEmoji](/workspace/chat/api/reference/rest/v1/customEmojis#CustomEmoji).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chat.customemojis`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
