---
title: "POST /v1/{+parent}/reactions"
method: POST
path: "/v1/{+parent}/reactions"
tags: ["spaces"]
---

# POST /v1/{+parent}/reactions

`POST /v1/{+parent}/reactions`

Creates a reaction and adds it to a message. For an example, see [Add a reaction to a message](https://developers.google.com/workspace/chat/create-reactions). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.messages.reactions.create` - `https://www.googleapis.com/auth/chat.messages.reactions` - `https://www.googleapis.com/auth/chat.messages` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)

## Path parameters

- `parent` string, required

## Request body

- Reaction — A reaction to a message.
  - `name` string — Identifier. The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}`
  - `emoji` Emoji — An emoji that is used as a reaction to a message.
    - `customEmoji` 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`.
    - `unicode` string — Optional. A basic emoji represented by a unicode string.
  - `user` User — A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`.
    - `isAnonymous` boolean — Output only. When `true`, the user is deleted or their profile is not visible.
    - `name` string — Resource name for a Google Chat user. Format: `users/{user}`. `users/app` can be used as an alias for the calling app bot user. For human users, `{user}` is the same user identifier as: - the `id` for the [Person](https://developers.google.com/people/api/rest/v1/people) in the People API. For example, `users/123456789` in Chat API represents the same person as the `123456789` Person profile ID in People API. - the `id` for a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. - the user's email address can be used as an alias for `{user}` in API requests. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can use `users/user@example.com` as an alias to reference `users/123456789`. Only the canonical resource name (for example `users/123456789`) will be returned from the API.
    - `type` 'TYPE_UNSPECIFIED' | 'HUMAN' | 'BOT' — User type.
    - `displayName` string — Output only. The user's display name.
    - `domainId` string — Unique identifier of the user's Google Workspace domain.

## 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)