- Category: productivity
- Auth: OAUTH2
- Composio-managed OAuth available? No
- Tools: 46
- Triggers: 0
- Slug:
GOOGLE_CHAT - Version: 20261101_00
Tools
Complete Space Import
Complete Space Import
GOOGLE_CHAT_COMPLETE_IMPORTCompletes the import process for an import-mode Google Chat space and makes it visible to users. Use this action at the end of a data migration into Google Workspace, after all messages and memberships have been imported into a space that was created with importMode: true. Requires user authentication with domain-wide delegation (service-account flow) and the chat.import OAuth scope. Cannot be called with regular user OAuth.Input Parameters
spaces/{space}. The space must have been created with importMode: true and the import must be complete before calling this.Output
Create Custom Emoji
Create Custom Emoji
GOOGLE_CHAT_CREATE_CUSTOM_EMOJICreates a custom emoji in Google Chat for use within a Google Workspace organization. An administrator must enable custom emojis for the organization.Input Parameters
Output
Create Space Member
Create Space Member
GOOGLE_CHAT_CREATE_MEMBERCreates a membership for a user, Chat app, or Google Group in a space. When creating a membership, if the member has auto-accept turned off, they’re invited and must accept the invitation before joining. Use this action when you need to add a new member to a Google Chat space. This can be used to invite individual users, add Chat apps, or add Google Groups to a space. If the member requires acceptance, they will receive an invitation. Note: parent must be the resource name of a space that already exists - this action does not create one. To start a new direct message with a user, use GOOGLE_CHAT_SET_UP_SPACE instead, which creates the DM space and adds the member in one call. Note: App authentication cannot add users external to the Workspace organization, add Google Groups, or add Chat apps to a space.Input Parameters
spaces/{space}.true, the method runs using the user’s Google Workspace administrator privileges. Requires the chat.admin.memberships scope.Output
Create Message
Create Message
GOOGLE_CHAT_CREATE_MESSAGECreates a message with text or cards in an existing Google Chat space, up to 32,000 bytes, or replies to a thread. Named-thread replies default to failing if the thread is missing; use GOOGLE_CHAT_SET_UP_SPACE to create a direct-message space first.Input Parameters
client- and contain only lowercase letters, numbers, and hyphens (max 63 chars).Output
Create Reaction
Create Reaction
GOOGLE_CHAT_CREATE_REACTIONCreates an emoji reaction on a Google Chat message. Use this action when you need to add an emoji reaction (like 👍, ❤️, or 🎉) to an existing message in a Google Chat space. Either emoji_unicode or emoji_custom_id is required, but not both. This action is useful for acknowledging messages, voting on ideas, expressing emotions in response to messages, or building interactive message features in Google Chat bots.Input Parameters
Output
Create section
Create section
GOOGLE_CHAT_CREATE_SECTIONCreates a custom section in Google Chat for organizing conversations in the navigation panel. Use when you need to create a new custom section to organize spaces and direct messages in the user’s Chat sidebar.Input Parameters
Output
Create Space
Create Space
GOOGLE_CHAT_CREATE_SPACECreates a named space in Google Chat. The calling user is automatically added as a member and space manager. For a group chat or direct message, use GOOGLE_CHAT_SET_UP_SPACE instead. Use this action when you need to create a discoverable named space for team collaboration or project discussions. For group conversations without a named space, use GOOGLE_CHAT_SET_UP_SPACE. Note: If you receive the error ALREADY_EXISTS when creating a space, try a different displayName. The displayName must be unique within the organization.Input Parameters
Output
Delete Custom Emoji
Delete Custom Emoji
GOOGLE_CHAT_DELETE_CUSTOM_EMOJIDeletes a custom emoji from Google Chat. By default, users can only delete custom emojis they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. Use this action when you need to permanently remove a custom emoji that is no longer needed. This action is irreversible — once deleted, the custom emoji cannot be recovered.Input Parameters
Output
Delete Member from Space
Delete Member from Space
GOOGLE_CHAT_DELETE_MEMBERRemoves a user, Google Group, or app membership from a Google Chat space using its membership resource name. The request can use Google Workspace administrator privileges when authorized. A membership that is not found is reported as an error.Input Parameters
Output
Delete Message
Delete Message
GOOGLE_CHAT_DELETE_MESSAGEDeletes a message from a Google Chat space; with user authentication, the force option can also delete its threaded replies. Deletion is irreversible, and permitted actions depend on the caller’s authentication and permissions.Input Parameters
Output
Delete Reaction
Delete Reaction
GOOGLE_CHAT_DELETE_REACTIONDeletes a reaction to a message. Use when you need to remove a reaction that was previously added to a message. Users can only delete their own reactions. This action is irreversible — once the reaction is deleted, it cannot be recovered.Input Parameters
Output
Delete section
Delete section
GOOGLE_CHAT_DELETE_SECTIONDeletes a custom section from Google Chat by its ID. This action is irreversible — once a section is deleted, it cannot be recovered. If the section contains items (such as spaces), they are moved to Google Chat’s default sections and are not deleted. Use when you need to remove a custom section that is no longer needed.Input Parameters
Output
Delete space
Delete space
GOOGLE_CHAT_DELETE_SPACEDeletes a named space from Google Chat. Always performs a cascading delete, which means that the space’s child resources like messages and memberships are also deleted. Use this action when you need to permanently remove a Google Chat space and all associated data. This action is irreversible — the space and all its messages and memberships cannot be recovered once deleted.Input Parameters
Output
Download Media
Download Media
GOOGLE_CHAT_DOWNLOAD_MEDIADownloads the bytes of a Google Chat message attachment via the media API. Use this after get_attachment to fetch the actual file content for an attachment. The resource_name parameter is the attachmentDataRef.resourceName returned by get_attachment. Returns the downloaded file. The download endpoint adds ?alt=media automatically, which is required by Google to return raw bytes rather than the JSON Media resource.Input Parameters
attachmentDataRef.resourceName returned by get_attachment or by a message that includes an attachment. Example: spaces/AAAA/messages/BBBB.BBBB/attachments/CCCC (URL-encoded by the action).Output
Find Direct Message
Find Direct Message
GOOGLE_CHAT_FIND_DIRECT_MESSAGEReturns the existing direct message space with the specified user. Use this action when you need to find an existing DM space with a particular user, such as when checking if a DM already exists before creating one or when you need the space resource name for subsequent operations. If no direct message space exists with the specified user, this action returns a NOT_FOUND (404) error. Note: This only finds existing DM spaces - it does not create a new one. To start a new DM (or safely get-or-create one), use the GOOGLE_CHAT_SET_UP_SPACE action instead.Input Parameters
Output
Find Group Chats
Find Group Chats
GOOGLE_CHAT_FIND_GROUP_CHATSFinds group chat spaces whose human memberships contain exactly the calling user and the specified users. Results are paginated.Input Parameters
Output
Get Attachment
Get Attachment
GOOGLE_CHAT_GET_ATTACHMENTGets the metadata of a Google Chat message attachment. Returns the attachment’s content type, filename, source, and references that can be used to download the file via the media API. To fetch the binary bytes of the attachment, pass the returned attachmentDataRef.resourceName to the download_media action. Requires Chat app authentication (the chat.bot scope) — this endpoint is not callable with regular user OAuth.Input Parameters
spaces/{space}/messages/{message}/attachments/{attachment}.Output
Get Custom Emoji
Get Custom Emoji
GOOGLE_CHAT_GET_CUSTOM_EMOJIReturns details about a custom emoji in Google Chat. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. Use this action when you need to retrieve information about a specific custom emoji, such as its name, unique identifier, or temporary image URL. This is useful for displaying emoji details or verifying emoji existence before performing other operations. Note: The payload field is only populated when creating or updating custom emojis and is not returned when getting emoji details.Input Parameters
customEmojis/{customEmoji} You can use the emoji name as an alias for {customEmoji}. For example, customEmojis/:example-emoji: where :example-emoji: is the emoji name for a custom emoji.Output
Get Chat Space Member
Get Chat Space Member
GOOGLE_CHAT_GET_MEMBERReturns details about a membership in a space. Use this action when you need to retrieve information about a specific member’s relationship with a Google Chat space, including their role, state, and user details.Input Parameters
Output
Get Message
Get Message
GOOGLE_CHAT_GET_MESSAGEReturns details about a specific message in a Google Chat space. Use this action when you need to retrieve the full content, sender information, thread details, and other metadata for a particular message. Requires user authentication with an appropriate Google Chat OAuth scope.Input Parameters
Output
Get Space
Get Space
GOOGLE_CHAT_GET_SPACERetrieves details of a specific Google Chat space, including its display name, description, membership count, threading state, and available configuration. Administrator access can be requested when authorized; some response fields depend on the scopes used.Input Parameters
Output
Get Space Event
Get Space Event
GOOGLE_CHAT_GET_SPACE_EVENTReturns an event from a Google Chat space. The event payload contains the most recent version of the resource that changed. Use this action when you need to retrieve details about a specific space event, such as a new message, membership change, reaction, or space update. If the resource was modified after the event occurred, the server returns the updated resource in the event payload. Note: The permissionSettings field is not returned in the Space object of the Space event.Input Parameters
Output
Get Space Notification Setting
Get Space Notification Setting
GOOGLE_CHAT_GET_SPACE_NOTIFICATION_SETTINGGets the notification settings for a user in a specific space. Use when you need to retrieve the caller’s space notification setting, including whether notifications are muted and what type of notifications are enabled. Requires user authentication with the https://www.googleapis.com/auth/chat.users.spacesettings OAuth scope.Input Parameters
Output
Get space read state
Get space read state
GOOGLE_CHAT_GET_SPACE_READ_STATEReturns details about a user’s read state within a space. Use this action when you need to identify which messages in a space have been read or unread by the user.Input Parameters
Output
Get thread read state
Get thread read state
GOOGLE_CHAT_GET_THREAD_READ_STATEReturns details about a user’s read state within a thread. Use this action when you need to identify which messages in a specific thread have been read or unread by the user.Input Parameters
Output
List custom emojis
List custom emojis
GOOGLE_CHAT_LIST_CUSTOM_EMOJISLists custom emojis visible to the authenticated user in Google Chat. Use this action when you need to retrieve all custom emojis available in Google Chat for the authenticated user. This is useful for displaying available emojis, filtering by creator, or enumerating organization-specific custom emojis. Supports pagination via pageSize and pageToken parameters. By default, returns up to 25 emojis.Input Parameters
Output
List Space Members
List Space Members
GOOGLE_CHAT_LIST_MEMBERSLists a page of memberships in a Google Chat space, with optional role or member-type filters and options to include Google Groups or invited members. Use the returned nextPageToken to fetch subsequent pages.Input Parameters
role) and type (member.type). To filter by role, set role to ROLE_MEMBER or ROLE_MANAGER. To filter by type, set member.type to HUMAN or BOT. You can also filter for member.type using the != operator. To filter by both role and type, use the AND operator. To filter by either role or type, use the OR operator. Either member.type = "HUMAN" or member.type != "BOT" is required when use_admin_access is set to true. Other member type filters will be rejected.true, also returns memberships associated with a Google Group, in addition to other types of memberships. If a filter is set, Google Group memberships that don’t match the filter criteria aren’t returned.true, also returns memberships associated with invited members, in addition to other types of memberships. If a filter is set, invited memberships that don’t match the filter criteria aren’t returned. Currently requires user authentication.true, the method runs using the user’s Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege. Requires either the chat.admin.memberships.readonly or chat.admin.memberships OAuth 2.0 scope. Listing app memberships in a space isn’t supported when using admin access.Output
List Messages
List Messages
GOOGLE_CHAT_LIST_MESSAGESLists non-system messages from one Google Chat space, with creation-time or thread filtering and a next-page token. It does not search message text or filter by sender; use GOOGLE_CHAT_SEARCH_MESSAGES for text search. Declared OAuth requirements include a Chat messages scope and directory.readonly.Input Parameters
create_time) and thread (thread.name). To filter by date, specify create_time with an RFC-3339 timestamp in double quotes, e.g. "2023-04-21T11:30:00-04:00". Use > for after, < for before, and combine two timestamps with AND for a time interval. To filter by thread, specify thread.name formatted as spaces/{space}/threads/{thread} (only one thread.name per query). Combine thread and date with AND. Invalid queries are rejected by the server with INVALID_ARGUMENT. Note: filtering by sender is NOT supported.spaces/{space}. Pass the complete name returned by GOOGLE_CHAT_LIST_SPACES, not only the space ID.Output
List reactions on a message
List reactions on a message
GOOGLE_CHAT_LIST_REACTIONSLists a page of emoji reactions on a specific Google Chat message. Results can be filtered by emoji type or user, and a page token can be used to retrieve subsequent pages.Input Parameters
Output
List Section Items
List Section Items
GOOGLE_CHAT_LIST_SECTION_ITEMSLists all items (such as spaces) within a specified section of a user’s Google Chat. Use when you need to retrieve all items grouped under a section in Google Chat, or when implementing pagination to fetch all items across multiple pages. Sections can be system sections like ‘default-spaces’ or custom sections created by the user. Requires user authentication with the https://www.googleapis.com/auth/chat.users.sections.readonly (read-only) or https://www.googleapis.com/auth/chat.users.sections (full access) OAuth scope.Input Parameters
space = spaces/{space}. Invalid queries are rejected with an INVALID_ARGUMENT error.Output
List Sections
List Sections
GOOGLE_CHAT_LIST_SECTIONSLists all sections available to the authenticated user in Google Chat. Use this action when you need to retrieve all sections for organizing conversations in the navigation panel. Sections include custom sections created by the user and system sections like default direct messages, default spaces, and default apps. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.users.sections - https://www.googleapis.com/auth/chat.users.sections.readonlyInput Parameters
Output
List Space Events
List Space Events
GOOGLE_CHAT_LIST_SPACE_EVENTSLists events from a Google Chat space. Use when you need to retrieve historical events such as new messages, membership changes, or reactions from a specific Google Chat space. The filter parameter is required and must specify event type filters. Note: This action requires specifying event type filters in the filter parameter. Supported event types include message events (created, updated, deleted), membership events (created, updated, deleted), and reaction events.Input Parameters
Output
List Spaces
List Spaces
GOOGLE_CHAT_LIST_SPACESLists a page of Google Chat spaces the authenticated user belongs to, using the chat.spaces or chat.spaces.readonly OAuth scope. Group chats and direct messages are not listed until the first message is sent.Input Parameters
Output
Move Section Item
Move Section Item
GOOGLE_CHAT_MOVE_SECTION_ITEMMoves a space from one section to another in Google Chat. Use when organizing spaces into different sections, such as moving a space from the default-spaces section to a custom user-created section. The action updates the section membership of the specified space item.Input Parameters
users/{user}/sections/{section} — a bare section ID is rejected.Output
Replace Message (Full)
Replace Message (Full)
GOOGLE_CHAT_REPLACE_MESSAGEUpdates a Google Chat message using a field mask, with support for text, cards, attachments, and other supplied properties. It can request creation of a missing message using a client-assigned ID.Input Parameters
Output
Search Messages
Search Messages
GOOGLE_CHAT_SEARCH_MESSAGESSearches for messages across Google Chat spaces the caller has access to. Use this action to find messages by keyword, sender, space, attachment presence, or mentions, instead of paging through ListMessages for a single space. Excludes private messages, Chat app messages, messages from blocked users, and messages in muted spaces. Requires user authentication with one of the following core OAuth scopes: - https://www.googleapis.com/auth/chat.messages - https://www.googleapis.com/auth/chat.messages.readonly Some filters and FULL-view metadata require the additional scopes documented on their request fields. Display-name enrichment is best-effort and optional.Input Parameters
create_time (only </>=, e.g. create_time >= "2024-01-01T00:00:00Z"), sender.name (= only, resource name of a user, e.g. users/123456789), space.name (= only), space.display_name (partial match with :, e.g. space.display_name:"Eng Showcase"; requires chat.spaces or chat.spaces.readonly), attachment (presence check with attachment:*), and annotations.user_mentions.user.name (: match). Advanced functions is_unread() (requires chat.users.readstate or chat.users.readstate.readonly) and has_link() are also supported. Combine different fields with AND.spaces/-; restrict searches to specific spaces with space.name or space.display_name in filter.Output
Search Spaces
Search Spaces
GOOGLE_CHAT_SEARCH_SPACESSearches Google Chat spaces using filters such as display name, customer, creation time, activity, history state, and space type. Searches can use administrator access across a Workspace organization or user access to spaces the caller belongs to.Input Parameters
create_time, customer, display_name, external_user_allowed, last_active_time, space_history_state, space_type. Examples: customer = "customers/my_customer" AND space_type = "SPACE", display_name:"Project*", create_time > "2024-01-01T00:00:00Z".membership_count.joined_direct_human_user_count, last_active_time, create_time. Valid ordering operation values: ASC (ascending, default) and DESC (descending). Example: membership_count.joined_direct_human_user_count DESC.true. Runs the search using Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with one of the admin scopes (chat.admin.spaces or chat.admin.spaces.readonly).Output
Setup Space
Setup Space
GOOGLE_CHAT_SET_UP_SPACECreates a Google Chat named space, group chat, human DM, or calling-app DM and can add initial members. The caller is added automatically. Named spaces require displayName. Group chats require at least two memberships. Human DMs require exactly one HUMAN membership. For a calling-app DM, set singleUserBotDm to true and omit memberships. An existing human DM is returned. Google groups can only join named spaces. This is the only action that creates DIRECT_MESSAGE or GROUP_CHAT spaces; CREATE_SPACE, CREATE_MESSAGE, and CREATE_MEMBER require an existing space. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.createInput Parameters
Output
Update Member
Update Member
GOOGLE_CHAT_UPDATE_MEMBERUpdates a user’s membership role in a Google Chat space, such as changing between member and manager.Input Parameters
spaces/{space}spaces/{space}/members/{member}true, the method runs using the user’s Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege.Output
Update Message
Update Message
GOOGLE_CHAT_UPDATE_MESSAGEUpdates a Google Chat message’s text, cards, or other supported properties using an update mask. With allowMissing enabled, it can create a message when the specified message is missing; permitted updates depend on authentication and permissions.Input Parameters
Output
Update section
Update section
GOOGLE_CHAT_UPDATE_SECTIONUpdates a section’s display name in Google Chat. This action uses patch semantics for partial updates. Use when you need to rename an existing custom section in Google Chat. Only sections of type ‘CUSTOM_SECTION’ can be updated. System sections (like ‘default-direct-messages’, ‘default-spaces’, ‘default-apps’) cannot have their display names modified. Requires user authentication with the ‘https://www.googleapis.com/auth/chat.users.sections’ scope.Input Parameters
Output
Update Space
Update Space
GOOGLE_CHAT_UPDATE_SPACEUpdates an existing Google Chat space’s display name, description, guidelines, history state, or predefined permission settings using an update mask. It can request administrator access when authorized.Input Parameters
description or guidelines, use spaceDetails in the update mask (both fields live under the spaceDetails object).Output
Update Space Notification Setting
Update Space Notification Setting
GOOGLE_CHAT_UPDATE_SPACE_NOTIFICATION_SETTINGUpdates the notification settings for a user in a space. Use when you need to modify how a user receives notifications in a specific space, such as muting a noisy channel or changing the notification level to only important messages. Requires user authentication with the chat.users.spacesettings scope.Input Parameters
Output
Update Space Read State
Update Space Read State
GOOGLE_CHAT_UPDATE_SPACE_READ_STATEUpdates a user’s read state within a space, used to mark messages as read or unread. Use this action when you need to programmatically mark a Google Chat space as read or update the user’s read position in a space. Note: To mark a space as unread, set lastReadTime to a value earlier than the latest message timestamp. To mark as read, set it to any value later than the latest message.Input Parameters
Output
Upload Media Attachment
Upload Media Attachment
GOOGLE_CHAT_UPLOAD_MEDIAUploads a file of up to 200 MB as an attachment to a Google Chat space using the multipart media upload endpoint; the returned attachment upload token can be used in a subsequent message. Requires user authentication and either the chat.messages or chat.messages.create scope.Input Parameters
spaces/{space}.