Skip to main content
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Survey Response Event

Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

About Survey Response Events

Have you ever wanted to generate a lead in Salesforce when respondents take your survey? Or would you like to be notified when responses are updated via the Qualtrics API? Maybe you want to receive emails about responses uploaded via the Offline App but not submitted via the anonymous link. All of these use cases and more are possible using the survey response event.

The survey response event allows you to trigger different tasks when new responses are collected or existing responses are updated.
the survey response event in

Types of Survey Response Events

The following response types can be used to define a survey response event:
in a survey response event, choosing to trigger based on new responses or updates ones

  • Newly created responses: A new response has been submitted.
  • Response updated via the Qualtrics API: An existing response was edited using the Qualtrics API.
    Qtip: For help writing the API call for updating responses, check out our API Documentation.
Qtip: If you want this task to fire for all responses, you should select both created and updated responses.
Attention: Incomplete responses will not trigger a workflow unless your workflow has conditions and the incomplete response fulfills those conditions.

Setting Up a Survey Response Event

  1. In the Workflows section of a project or the stand-alone Workflows page, click Create a workflow. For survey response events, we generally recommend you create the workflow in the Workflows tab of a project.
    In the workflows tab, clicking "create a workflows" and then "started when an event is received"
  2. Choose Started when an event is received.
  3. Choose the Survey response event.
    choosing the survey response event
  4. Set the type of survey response event.
    choosing the type of survey response event and how to handle multi language responses
  5. If you want, select Include imported responses. If this isn’t selected, importing responses will not trigger the workflow.
  6. If you want, select Include incomplete responses. If this isn’t selected, incomplete responses that have been closed will not trigger the workflow.
  7. If your survey is available in multiple languages, choose how response data is handled. See Survey Response Events for Multi-Language Surveys for more information.
  8. Click Finish.
  9. If desired, click the plus sign ( + ) and choose Add a condition to add conditions to your workflow. Conditions determine the criteria for your workflow to fire. See the setting conditions for a survey response event section for more details.adding a task and condition
  10. Click the plus sign ( + ) and select Task to add a task to your workflow. Tasks determine the result of your workflow. See defining tasks for an explanation of every available task.

Survey Response Events for Multi-Language Surveys

Qtip: If your survey is only available in one language, it doesn’t matter what you choose for this option.

If your survey is translated into multiple languages, you can specify which language to process response data in. This option is useful if you need your responses to be in a certain language for sending the data to a third-party system using the same workflow. This option also lets you pipe text in a language other than the survey’s default language.

Example: We want to send response summaries to our department head for review. While the survey data has been collected in many different languages, we want to show it to her in French, the department head’s native language.
Example: Let’s say we want to map the respondent’s answers back to fields in Salesforce. If the Salesforce object can’t handle non-English characters, then we’ll want our respondent’s answers translated to English so that they can be imported to Salesforce.
Qtip: This option only impacts the response data for using the data in the same workflow. It does not impact how the response is saved in data & analysis. The response will be saved in the language that the respondent took the survey in.

Under Select what language to receive response data in, choose between the following:

The user interface says select what language to receive a response in, then has the following options

  • Keep the language the response was received in: The response data will not be translated and will remain in the language that the respondent took the survey in. This option is selected by default.
  • Resolve translations into another language: Choose from one of the languages the survey is already translated into.
    Warning: Text entry responses cannot be translated as part of this feature. For similar functionality, see translate comments.
    Qtip: This option does not use an external translation service. We use the translations that are provided by you when you translate your survey.

Example: Let’s say we distribute a survey in both English and French. In the same workflow as our survey response event, we have an email task to send an email. We want to pipe in the respondent’s answers (bolded in the example images) into the email. What appears in the email depends on what we choose for this option.

  • If we choose “Keep the language the response was received in,” then the respondent’s answers will appear in the email in the same language that the respondent took the survey in. So if the respondent took the survey in French, then the email will have French answers in it.
    the email task showing piped text in French
  • If we choose “Resolve translations into another language: English,” then all respondent answers will appear in English.
    the email trigger showing piped text in English

Setting Conditions for a Survey Response Event

Conditional statements apply All or Any to define when a task should be triggered. In “all” conditions, every condition listed below must be met. It is similar to joining statements by “and.” In “any” conditions, any of the conditions can be met, but not all have to be. It is similar to joining statements by “or.”

Example: In this example, only one of the two conditions must be met for the task to be triggered.
a condition for the survey response event for offline app responses in the europe region

The conditions you set for a survey response event can be based off of various pieces of information about the response.

  • Question: How the respondent answered a question.
  • Embedded Data: The value of an embedded data field.
  • Quota: Quota counts for quotas in your survey.
  • Status: The type of survey response.
    Qtip: By default, imported responses will not trigger tasks. They will only trigger tasks if there are conditions that do not exclude imported responses. For example, if a condition is set to Status is Equal to Normal, then imported responses will not trigger the task. If a condition is set to Status is Not Equal to Preview, then imported responses will trigger the task.
  • Respondent:  A grouping based on a segment in the XM Directory.

FAQs