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

Get Survey Definition Task


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!


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

  1. Navigate to the Workflows tab in your project or the stand-alone Workflows page.
    in the workflows tab, clicking create a workflow and choosing the type of workflow
  2. Click Create a workflow.
  3. 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.
  4. Click the plus sign ( + ) and then Add a condition to set up conditions for your workflow.
    clicking the plus sign and then conditions
  5. Click the plus sign ( + ) and then Add a task.
    clicking the plus sign and then task
  6. Select Survey Definition.
    survey definition task within the task catalog
  7. Select a survey project to retrieve the definition from.
    button to select a survey to configure the task
  8. 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.