Method: spaces.messages.get

Stay organized with collections Save and categorize content based on your preferences.

Returns a message. For example usage, see Read a message.

Requires authentication. Fully supports Service account authentication.

Supports user authentication as part of the Google Workspace Developer Preview Program, which grants early access to certain features. User authentication requires the chat.messages or chat.messages.readonly authorization scope.

Note: Might return a message from a blocked member or space.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Resource name of the message to retrieve.

Format: spaces/{space}/messages/{message}

If the message begins with client-, then it has a custom name assigned by a Chat app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see create and name a message.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Message.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authorization guide.