Surveys Responses Using Invitation ID (POST, PATCH)

Initialize the process of submitting survey responses and return the details of the first page of the survey by making a POST request. Submit the survey responses using the PATCH request. You can create a survey to collect data from customers, employees, or other people whose feedback you need. The survey responses are stored in the SurveyResponse object and the responses to individual questions in the SurveyQuestionResponse object.

Salesforce Feedback Management (SFM) Business API performance can be impacted if a POST request exceeds 5,400 calls per minute and if a PATCH request exceeds 2,700 calls per minute at the org level. For more rate limit information, see Connect REST API Limits.

The Feedback Management - Starter and Feedback Management - Growth licenses are required to use this resource.

Where SURVEY_ID and SURVEY_INVITATION_ID are variables.

56.0

POST, PATCH

The HTTP header request format only accepts Content-Type: application/json.

<SurveyDescriptionInput>

Name	Type	Description	Required or Optional	Available Version
`invitationSettings`	Survey Invitation Settings Input	Invitation settings of the survey. The Invitation ID API doesn’t require the invitation configuration settings to be passed with the Survey Invitations.	Required	56.0
`languageCode`	String	Code of the language in which the survey is created.	Optional	56.0
`recipientEngagementContext`	Map<String, String>	Engagement context settings for a recipient of the survey.	Optional	56.0
`relatedRecordIds`	String[]	IDs of the records that are related to the survey.	Optional	56.0
`shouldLoadPartiallyCmplSurvey`	Boolean	Indicates whether to load partially completed surveys when a partially completed survey is selected (`true`), or to start a new survey (`false`). The default value is `false`.	Optional	63.0
`staticMergeFields`	Map<String, String>	Map of static merge field values.	Optional	56.0

Survey Description Output

<SurveyResponseInput>

Here’s an example for multiple questions.

Here’s an example for a single question.

Name	Type	Description	Required or Optional	Available Version
`flowInterviewState`	String	State of the flow interview.	Required	56.0
`invitationId`	String	ID of the survey invitation.	Required	56.0
`languageCode`	String	Code of the language that the survey is created in.	Optional	56.0
`navigationAction`	String	Available navigation actions on the survey page. Possible values are: `Back`—Navigate to the previous survey page. `Next`—Navigate to the next survey page.	Required	57.0
`surveyPageResponses`	Survey Page Response Input	Responses to the survey questions on a page.	Required	56.0

Survey Response Output