If the specified session entity type already exists, overrides the session entity type.
This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.
HTTP request
POST https://{endpoint}/v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes
Required. The session to create a session entity type for. Format: projects/<Project ID>/agent/sessions/<Session ID> or projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/
sessions/<Session ID>. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user.
Authorization requires the following IAM permission on the specified resource parent:
[[["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 document details the process of creating a session entity type, which, if it already exists, will be overridden.\u003c/p\u003e\n"],["\u003cp\u003eThe creation of a session entity type is performed via a \u003ccode\u003ePOST\u003c/code\u003e HTTP request to a specific endpoint, with the \u003ccode\u003eparent\u003c/code\u003e path parameter being mandatory to define the session.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization, specifically the \u003ccode\u003edialogflow.sessionEntityTypes.create\u003c/code\u003e IAM permission on the \u003ccode\u003eparent\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an instance of \u003ccode\u003eSessionEntityType\u003c/code\u003e, and the response body, if successful, will return the newly created instance of \u003ccode\u003eSessionEntityType\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality is incompatible with Google Assistant integration, and Dialogflow support should be contacted for such use cases.\u003c/p\u003e\n"]]],[],null,["# Method: projects.agent.environments.users.sessions.entityTypes.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_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 session entity type.\n\nIf the specified session entity type already exists, overrides the session entity type.\n\nThis method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.\n\n### HTTP request\n\n`POST https://{endpoint}/v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes`\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### Request body\n\nThe request body contains an instance of [SessionEntityType](/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [SessionEntityType](/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType).\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)."]]
