Get Survey Definition Task
Qtip: This page describes functionality that we intend to release starting October 1, 2025. Qualtrics may, in its sole discretion and without liability, change the timing of any product feature rollout, change the functionality for any in preview or in development product feature, or choose not to release a product feature or functionality for any reason or for no reason.
About the Get Survey Definition Task
The Get Survey Definition task allows you to retrieve the survey definition from any survey. This makes the full survey structure and content, including questions and embedded data fields, available for use in later tasks in the workflow. For example, you can set up a custom response report using content from the survey definition.
Qtip: This task only returns information about the design of the survey and does not include details about how respondents answered the questions in your survey.
Attention: This task uses the Get Survey API endpoint and will count towards your brand’s API request limits.
Creating a Get Survey Definition Task
- Navigate to the Workflows tab in your project or the stand-alone Workflows page.
- Click Create a workflow.
- Choose if you want the workflow to be triggered by an event or run on a schedule. (See a comparison.)
Qtip: The survey response creation event is the most common.
- Click the plus sign ( + ) and then Add a condition to set up conditions for your workflow.
- Click the plus sign ( + ) and then Add a task.
- Select Survey Definition.
- Select a survey project to retrieve the definition from.
- Click Save.
Once your task has been set up, you can use the survey definition details in later tasks in your workflow.
Example: Set up an Email task that uses piped text from the survey definition to send a custom response report to respondents that finish your survey.