Method: conversations.surveys.create

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

Creates a customer satisfaction survey in a conversation.

If an agent sends multiple surveys in the same conversation within 24 hours, Business Messages only attempts to send the first survey to the user.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The conversation that contains the survey. Resolves to "conversations/{conversationId}".

Query parameters



The unique identifier of the survey, assigned by the agent. If a survey attempts to use the same surveyId as a previous survey, Business Messages ignores the request.

Request body

The request body contains an instance of Survey.

Response body

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

Authorization Scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.