Loading...
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM

Survey Definition Events

What's on This Page:


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 Definition Events

Survey Definition Events allow you to trigger Actions based on changes to a project’s status. You can base your event on a survey being published, activated, or closed.
the survey definition event in the event selection window

Qtip: To use this feature, you must be a Brand Administrator.
Qtip: This event can only be set up in the Actions Page.
Example: For example, I can create an action so that I am notified every time a user in my license publishes a survey.

Setting up a Survey Definition Event

  1. Navigate to the Actions page by clicking Actions in the top right corner.
    the create an action button in the actions page. event based action is selected

    Qtip: You cannot use this event in the Actions tab of an individual survey.
  2. Click Create an action.
  3. Select Event-based.
  4. Give your action a name.
    the choose event button for an action
  5. Click Choose Event.
  6. Select the Survey Definition Event.
    the survey definition event in the event selection window
  7. Choose the survey status change that causes the action to trigger.
    the window for choosing what type of survey status changes you want to trigger the action
    You may choose multiple statuses. Your options include:

    • Activated: Begin the workflow when a survey is activated.
    • Closed: Begin the workflow when a survey is closed.
    • Published: Begin the workflow when the survey is published.
  8. Click Finish.
  9. Click Add conditions.
    the add conditions button in the actions editor
  10. Click + Condition and build your conditions for the event to trigger. See Setting Conditions for Survey Definition Events for more information about the conditions available for this event.
    the condition button for adding a condition

    Example: In this example, I want the action to trigger for only one specific survey, which is indicated by the Survey ID condition.
    an example condition to trigger the survey when the survey ID is equal to a specific survey's ID
    Qtip: If you do not set conditions for this event, then the action will trigger any time a survey in your brand undergoes your selected survey status change.
  11. When finished building your conditions, click Done Editing.
    the add task button for an action
  12. Click Add Task.
  13. Choose the task(s) you want to happen when the action is triggered. Visit this support page for more information about each available task.
    the add task window

    Example: For example, I can use an email task to automatically send my teammate an email letting them know that the survey data is ready to analyze.
  14. When finished setting up your action, return to the Actions page.
    enabling an action from the actions page
  15. Enable your action by clicking the On/Off toggle
Qtip: Visit the Reporting & History tab if you need to troubleshoot your action or see a log of when the action fired.

Setting Conditions for Survey Definition Events

Usually, you will want to include conditions as part of your action. If you do not include conditions, then the action will trigger for any status change for any survey in your brand. When creating conditions for a survey definition event, you can base your conditions on the following fields:

the available fields for basing a condition for a survey definition event

  1. Survey ID: This is the Survey ID for the survey that should trigger the action.
    Qtip: You can only use this condition for projects that have a survey ID beginning in SV_.
  2. Survey Data: Create a condition based on various survey data fields, such as when the survey was last modified or a survey owned by a specific user.
    the survey data fields available for conditions

    • Survey Name: The survey’s name.
    • Survey Status: The survey’s status.
    • Owner ID: The user ID of the user who owns the survey.
    • Question Count: The number of questions in the survey.
    • Last Modified: The time when the survey was last edited.
    • Organization ID: The ID of the organization that owns the survey.
    • Creator ID: The user ID of the user who originally created the survey.
    • Last Activated: The time when the survey was last activated.