Method: projects.conversations.messages.batchCreate

Batch ingests messages to conversation. Customers can use this RPC to ingest historical messages to conversation.

HTTP request

POST https://{endpoint}/v2beta1/{parent=projects/*/conversations/*}/messages:batchCreate

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. Resource identifier of the conversation to create message. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>.

Authorization requires the following IAM permission on the specified resource parent:

  • dialogflow.messages.batchCreate

Request body

The request body contains data with the following structure:

JSON representation
  "requests": [
      object (CreateMessageRequest)

object (CreateMessageRequest)

Required. A maximum of 300 messages can be created in a batch. [CreateMessageRequest.message.send_time][] is required. All created messages will have identical Message.create_time.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.