Creates a new conversation. Conversations are auto-completed after 24 hours.
Conversation Lifecycle: There are two stages during a conversation: Automated Agent Stage and Assist Stage.
For Automated Agent Stage, there will be a dialogflow agent responding to user queries.
For Assist Stage, there's no dialogflow agent responding to user queries. But we will provide suggestions which are generated from conversation.
If Conversation.conversation_profile is configured for a dialogflow agent, conversation will start from Automated Agent Stage, otherwise, it will start from Assist Stage. And during Automated Agent Stage, once an Intent with Intent.live_agent_handoff is triggered, conversation will transfer to Assist Stage.
HTTP request
POST https://{endpoint}/v2/{parent=projects/*}/conversations
Required. Resource identifier of the project creating the conversation. Format: projects/<Project ID>/locations/<Location ID>.
Authorization requires the following IAM permission on the specified resource parent:
dialogflow.conversations.create
Query parameters
Parameters
conversationId
string
Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you.
The conversation ID must be compliant with the regression formula [a-zA-Z][a-zA-Z0-9_-]* with the characters length in range of [3,64]. If the field is provided, the caller is responsible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness.
Request body
The request body contains an instance of Conversation.
Response body
If successful, the response body contains a newly created instance of Conversation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis page details the process of creating a new conversation within the Dialogflow platform, including its lifecycle and various parameters.\u003c/p\u003e\n"],["\u003cp\u003eConversations transition between two distinct stages: an Automated Agent Stage, where a Dialogflow agent responds, and an Assist Stage, where suggestions are provided without a live agent.\u003c/p\u003e\n"],["\u003cp\u003eThe creation of a new conversation is initiated with a POST HTTP request to a specific endpoint using gRPC Transcoding syntax, while also having required parameter in the form of the project ID and location.\u003c/p\u003e\n"],["\u003cp\u003eThe conversation can be given an optional custom ID by the user, which must adhere to a specific format and maintain uniqueness, or else it will automatically be generated by the system.\u003c/p\u003e\n"],["\u003cp\u003eThe request and response for the creation of the conversation contain an instance of the \u003ccode\u003eConversation\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.conversations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new conversation. Conversations are auto-completed after 24 hours.\n\nConversation Lifecycle: There are two stages during a conversation: Automated Agent Stage and Assist Stage.\n\nFor Automated Agent Stage, there will be a dialogflow agent responding to user queries.\n\nFor Assist Stage, there's no dialogflow agent responding to user queries. But we will provide suggestions which are generated from conversation.\n\nIf [Conversation.conversation_profile](/dialogflow/es/docs/reference/rest/v2/projects.conversations#Conversation.FIELDS.conversation_profile) is configured for a dialogflow agent, conversation will start from `Automated Agent Stage`, otherwise, it will start from `Assist Stage`. And during `Automated Agent Stage`, once an [Intent](/dialogflow/es/docs/reference/rest/v2/projects.agent.intents#Intent) with [Intent.live_agent_handoff](/dialogflow/es/docs/reference/rest/v2/projects.agent.intents#Intent.FIELDS.live_agent_handoff) is triggered, conversation will transfer to Assist Stage.\n\n### HTTP request\n\n`POST https://{endpoint}/v2/{parent=projects/*}/conversations`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Conversation](/dialogflow/es/docs/reference/rest/v2/projects.conversations#Conversation).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Conversation](/dialogflow/es/docs/reference/rest/v2/projects.conversations#Conversation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
