Get Survey Definition Task

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.

---

×

close

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.

---

×

close

Click the plus sign ( + ) and then Add a task.

---

×

close

Select Survey Definition.

---

×

close

Select a survey project to retrieve the definition from.

---

×

close

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.