Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Qualtrics Destination


Qualtrics(link takes you to an external page) is an Experience Management platform that allows companies to design and improve customer and employee experiences through listening, analysis and action. Power richer Qualtrics insights or perform action based on your event data using the Qualtrics destination


Benefits of Qualtrics (Actions)

benefits-of-qualtrics-actions page anchor

Qualtrics (Actions) provides the following benefits:

  • Keeping your contact data in sync. The Qualtrics destination provides actions to sync your contact data from your system of record up to date with Qualtrics XiD
  • Streamlined configuration. Qualtrics destination maps your event data to the Qualtrics API & Qualtrics xflow (workflows) out of the box

Limitations

limitations page anchor

The Qualtrics destination is only available to customers on a Business Tier plan with Segment.

To link your Qualtrics destination in Segment to your Qualtrics workspace, Qualtrics(link takes you to an external page) requires a Segment Token(link takes you to an external page) that can only be generated by Business Tier customers who have access to the Public API.


  1. From the Segment web app, click Catalog, then click Destinations.
  2. Find the Destinations Actions item in the left navigation, and click it.
  3. Click Configure Qualtrics.
  4. Select an existing Source to connect to Qualtrics (Actions).
  5. To authenticate, enter your API key & Datacenter ID. To locate your API key & Datacenter ID, follow in the instructions in the Finding your Qualtrics IDs(link takes you to an external page) documentation.

Property nameTypeRequiredDescription
API Tokenpassword
required

Qualtrics API token found in your Qualtrics account under "Account settings" -> "Qualtrics IDs."


Datacenter IDstring
required

Qualtrics datacenter id that identifies where your qualtrics instance is located. Found under "Account settings" -> "Qualtrics IDs".


Build your own Mappings. Combine supported triggers with the following Qualtrics-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Create and/or update contact in XM Directory

create-andor-update-contact-in-xm-directory page anchor

Create and/or update contact in XM Directory. Updating is handled by contact deduplication in your directory settings(link takes you to an external page). If deduplication is setup correctly this action will perform UPSERT operations on contacts

Create and/or update contact in XM Directory is a Cloud action. The default Trigger is type = "identify"

Property nameTypeRequiredDescription
Directory IDSTRING
required

Directory id. Also known as the Pool ID. POOL_XXX


External Data ReferenceSTRING

Optional

The external data reference which is a unique identifier for the user


EmailSTRING

Optional

Email of contact


Phone numberSTRING

Optional

Phone number of contact


First NameSTRING

Optional

First name of contact


Last NameSTRING

Optional

Last name of contact


LanguageSTRING

Optional

Language code of the contact


Contact is unsubscribedBOOLEAN

Optional

Should the contact be unsubscribed from correspondence


Contact embedded dataOBJECT

Optional

Contact embedded data (properties of the contact)

Start a workflow in Qualtrics

start-a-workflow-in-qualtrics page anchor

This action is used to kick off a workflow in Qualtrics

Start a workflow in Qualtrics is a Cloud action.

Property nameTypeRequiredDescription
Workflow URLSTRING
required

Event payloadOBJECT

Optional

A mapping of key values to send to Qualtrics xflow.

Upsert contact transaction

upsert-contact-transaction page anchor

Add a transaction to a contact in Qualtrics directory. If the contact already exists, add the transaction. If the contact does not exist, create the contact first, then add the transaction record.

Upsert contact transaction is a Cloud action. The default Trigger is type = "track", event = "Transaction Created"

Property nameTypeRequiredDescription
Directory IDSTRING
required

Directory id. Also known as the Pool ID. POOL_XXX


Mailing list IDSTRING
required

ID of the mailing list the contact belongs too. If not part of the event payload, create / use an existing mailing list from Qualtrics. Will have the form CG_xxx


Contact IDSTRING

Optional

The id of the contact to add the transaction. if this field is not supplied, you must supply an external data reference, email and/or phone so a look can be performed. If the lookup does not find a contact, one will be created with these fields and including the optionally supplied firstName, lastName, language, subscribed and embeddedData


External Data ReferenceSTRING
required

The external data reference which is a unique identifier for the user. This is only used to search for the contact and if a new contact needs to be created, it is not added to the transaction data.


EmailSTRING

Optional

Email of contact. This is only used to search for the contact and if a new contact needs to be created, it is not added to the transaction data.


Phone numberSTRING

Optional

Phone number of contact. This is only used to search for the contact and if a new contact needs to be created, it is not added to the transaction data.


First nameSTRING

Optional

First name of contact. This is only used if a new contact needs to be created and is not added to the transaction data.


Last nameSTRING

Optional

Last name of contact. This is only used if a new contact needs to be created and is not added to the transaction data.


LanguageSTRING

Optional

Language code of the contact. This is only used if a new contact needs to be created and is not added to the transaction data.


Contact is unsubscribedBOOLEAN

Optional

Should the contact be unsubscribed from correspondence. This is only used if a new contact needs to be created and is not added to the transaction.


Contact embedded dataOBJECT

Optional

Contact embedded data (properties of the contact). These are added to the contact only if a new contact needs to be created not added to the transaction.


Date & time of transactionDATETIME

Optional

Date and time of when the transaction occurred.


Transaction dataOBJECT

Optional

Properties of the transaction too add to the users record