Method: spaces.messages.create

Creates a message.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Space resource name, in the form "spaces/*". Example: spaces/AAAAMpdlehY

Query parameters



Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it.

Has no effect if thread field, corresponding to an existing thread, is set in message.



Optional. A unique request ID for this message. If a message has already been created in the space with this request ID, the subsequent request will return the existing message and no new message will be created.

Request body

The request body contains an instance of Message.

Response body

If successful, the response body contains a newly created instance of Message.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.