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

Migrating XM Directory Automations to Workflows

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 Migrating Automations to XM Directory Workflows

Workflows are the new and improved way to automate tasks in XM Directory, and have fully replaced automations. This page provides instructions on how to recreate common automations as workflows.

As of September 3, 2025, XM Directory automations compatible with workflows were automatically migrated to workflows. Any automations that were ineligible for the auto-migration had to be self-migrated manually to the Workflows platform before December 3, 2025.

Qtip: In addition to replacing the functionality of automations, workflows allow you to create more types of automated jobs for your XM Directory. You can schedule workflows to run based on changes to XM Directory contacts with the Experience ID Change Event, create workflows based on XM Directory segments, and more.

The standalone Workflows page is where you can create, edit, and manage all types of workflows. When replacing your legacy automations, this can be an easy, one-stop location to find all of your XM Directory workflows.

Standalone workflows are only available to the user who creates them, which is the same as XM Directory automations. If desired, you can share the workflow with other users in your license.

clicking the navigation menu in the top left, selecting Workflows, then standalone workflows at the bottom of the page

Workflow Schedules

All XM Directory automations are scheduled at regular intervals. Thus, the first step to replacing your automation is to create a scheduled workflow.

Qtip: Workflow notifications are replacing run reporting in Automations. Follow the instructions on the linked page to be notified when your workflow succeeds or fails.
  1. Click the navigation menu in the top lefthand corner of your account.
    creating a new scheduled workflow in the standalone workflows page
  2. Select Workflows.
  3. Click Create a workflow.
  4. Select Started at a specific time (scheduled).
  5. Select the Frequency from the dropdown menu.Set up a scheduled workflow
  6. Enter the Start days, Start times, Time zone, Start, and End fields. For more information, see Scheduled Workflows.
  7. Select Save.
  8. Next, determine if you want to import contacts on a regular schedule or send a distribution.

Contact Import Automations

Legacy contact import automations allowed you to automatically upload files of contacts from a source of your choice to XM Directory. Contacts came from a Secure File Transfer Protocol (SFTP) server, the Qualtrics File Service, or Google Drive. Workflows achieve this same functionality using ETL workflows, while also supporting several more sources, such as Amazon S3, Snowflake, and Salesforce. Follow the steps below to create a workflow that automatically uploads contacts.

  1. Create an ETL workflow.
    on workflows global page, clicking make workflow button, then selecting ETL option
  2. Set up your schedule.
    workflow with a schedule. button below for adding extraction task
  3. Select Data source (ETL extractor). 
  4. Depending on where your data’s stored, select a data extraction task. The most common include:
    new window with many extraction tasks to choose from

    Qtip: Workflows also supports other import sources, like Amazon S3, Snowflake, and Salesforce. For more information, see Building ETL Workflows.
    Qtip: Workflows do not support Gigya or Dropbox as data sources.
  5. Click Add a data destination.
    Add a data destination button highlighted in workflow editor
  6. Select the Add contacts and transactions to XMD task.
    XMD Contact Import task highlighted
  7. Choose the directory to map data to.
    new window where you configure the task
  8. Select a mailing list to map data to. You can also choose to create a new mailing list for this directory each time this workflow runs.
  9. Select a data source. This should be the data extractor task you set up in step 4.
  10. Many of your XM Directory fields will be mapped automatically. Double-check the results and make adjustments as needed.
    Fields for mapping XM Directory sources and fields

    Qtip: If you want to make changes to field mappings, you can make individual edits or upload a file. See Mapping Field Values.
  11. Use the Field type column to indicate whether each column is basic contact data, embedded data, or transaction data.
    Qtip: See Setting Up an Add Contacts and Transactions to XMD Task for more details, including differences between field types, and proper transaction date formats.
    Qtip: If you don’t map a transaction date field, the system will automatically map the workflow’s execution date as the transaction date.
  12. Click Save. 
Qtip: To create and distribute to a sample population, add a Create an XM Directory Sample task after your contact import task. Select Use a transaction batch generated from a previous task as the sample source.
Qtip: You can add a Basic Transform Task to your workflow to modify the values of the input data before importing it into your XM Directory.

Survey Distribution Automations

Legacy survey distribution automations allowed you to set up a scheduled survey distribution to a mailing list or a sample of a mailing list. This same functionality can be achieved with the Email task or Send Survey via Text Message (SMS) task within workflows. Follow the steps below to create a workflow that automatically distributes a survey to your contacts.

  1. Set up a scheduled workflow.
    Click the plus sign under the scheduled workflow and add a task
  2. Click the plus ( + ) sign.
  3. Select Add a task. 
  4. Select a distribution task:
    highlighted a distribution task

  5. Follow the steps from the pages linked above.
Attention: Do not use the XM Directory task, as it will eventually be deprecated. The Send Survey via Email Task offers enhanced functionality and should be used instead.

Linking Contact Import and Survey Distribution Automations

In legacy automations, you could link contact import and survey distribution automations together to send survey distributions to the contacts that were most recently imported. In Workflows, you can add the import and distribution tasks to a single unified workflow.

It is also possible to add multiple survey distribution tasks to the same workflow, so you can have multiple distributions sent after a single contact import task.

  1. Follow the steps from the Tasks to create Contact Import Automation section.
  2. Click the plus sign ( + ).
  3. Select Add a task.
    click the plus sign then select add a task
  4. Select a distribution task:
    send survey via email and text SMS are shown

    Attention: Do not use the XM Directory task, as it will eventually be deprecated. We recommend using the Send Survey via Email Task instead, since it offers not only the same email distribution capabilities, but a number of enhanced features.
  5. Follow the steps from the pages linked above.
  6. When you choose who to invite, instead of choosing a directory or mailing list, click Source, then select the Add contacts and transactions to XM Directory task you created earlier, for your contact automation.
    new window where you're configuring email task, says choose who you want to invite, and because the earlier contact import automation is chosen, you can now set it to deliver to that new list
  7. Under Type, select whether to send to the mailing list created, or to that specific transaction group.
    Attention: If you select List, the entire mailing list will be invited. If you select Transaction Group, only the newly added contacts in this workflow execution will be invited. If you don’t create a new mailing list every time the contact import runs, you should select Transaction Group.
  8. Complete your task. If you want, you can even repeat these steps to link additional distributions.
    Warning: Workflows only supports linking up to 8 distributions to your contact import automation. If you have a legacy automation that goes beyond this number, talk to your Technical Success Manager about alternate migration solutions. This limit is applicable when manually creating the new workflow.

Qtip: If you schedule your workflow to run on a frequent basis, but there isn’t a new file to extract from your chosen source, the workflow will not send the distribution, and mark it as failed. This is intended behavior, since if there isn’t a group of contacts to message, the message can’t go out. If you have workflow failed notifications turned on and want to avoid receiving too many, add a condition to your workflow between your contact import and the distribution. As seen below, you can set a condition so the distribution’s only sent if the file is not empty, thus eliminating the failures described.

plus sign between tasks lets you add a condition
follow branch if tasks add contacts and transactions to XMD transaction batch ID isn't empty

Qtip: To create and distribute to a sample population, add the Create an XM Directory Sample task after your contact import task, but before your distribution task. Select Use a transaction batch generated from a previous task as the sample source.

Run Summary Reports

Email tasks allow you to send a general email message with no survey link included. Because of this, email tasks are a great options if you want to create run reports, keeping your stakeholders updated on how many contacts were processed in each run.

  1. In the To field, enter emails of people or teams you’d like to receive the run report.
  2. Complete your email. In the body, you can generate piped text from either the contact extraction or the contact upload.
    email piped text

    • Extract data from (source): You can show email recipients the number of files or rows in all files imported. Number of rows can be a great way to show the number of contacts generated.
    • Add contacts and transactions to XMD: Display information such as the directory where the new contacts were uploaded, the list ID, or the transaction ID.

People Import Automations (EX)

In this section, we’ll discuss an automation that’s only available for Employee Experience customers, and is disconnected from XM Directory.

People import automations allowed you to automatically pull lists of employees from a source of your choice to your employee directory. In legacy automations, employees can come from a Secure File Transfer Protocol (SFTP) server, the Qualtrics File Service, or Google Drive. Workflows achieve this same functionality using ETL workflows, while also supporting several more sources, such as SuccessFactors, Workday, and more.

  1. Set up a scheduled workflow.
    Click the plus sign under the scheduled workflow and add a task
  2. Click the plus ( + ) sign.
  3. Select Add a task. 
  4. Create one of the following data extraction tasks:
    Highlighted data extraction tasks from step 4

    Qtip: Workflows also supports other import sources, like Amazon S3, Snowflake, and Salesforce. For more information, see Building ETL Workflows.
  5. Click Add a data destination.
    Add a data destination button highlighted
  6. Select the Load Users into EX Directory task.
    Select the task
  7. Follow the steps on Load Users into EX Directory Task.

Changes to Automations After Migrating to Workflows

Active XM Directory and EX automations were automatically migrated to Workflows beginning in Q3 2025.

Some automation configurations will change when they are migrated to Workflows. If your automations have at least one of the following features, there will be slight changes to your workflow:

  • Automations set to “on demand” that run every 15 minutes will change to run every hour. This is the most frequent setting available for scheduled workflows.
    Qtip: If you need your workflow to run every 15 minutes, you can log into the Customer Success Hub and contact Technical Support with your request.
  • Automations with linked distributions will be migrated as a single workflow that imports contacts and distributes surveys. If your automation exceeds 20 linked distributions, then your migrated workflow will exceed the 20 tasks in a workflow limit. You can edit your workflow as needed to remove extra tasks and consolidate distributions. This applies for existing automations that are eligible for automatic migration.
    Qtip: We recommend splitting your import and distribution workflows before the auto-migration period to ensure scale and performance optimization.
  • Automations with survey and reminder expiration in hours will have their expiration migrated to daily.

FAQs