Set up the Qualtrics spoke

Integrate the ServiceNow instance and Qualtrics by registering Qualtrics as an OAuth provider to authenticate ServiceNow requests.

Before you begin

  • Request an Integration Hub subscription.
  • Activate Qualtrics spoke.
  • Role required: admin

Obtain required details from Qualtrics account

Copy and record the values of token, Organization ID, Client ID, and Client secret from your Qualtrics account for authentication.

Before you begin

Role required: admin

Procedure

  1. Log in to your Qualtrics account as an admin.
  2. Navigate to Account Settings > Qualtrics IDs.
  3. Under User, copy and record the values of Organization ID and Datacenter ID.
  4. Under Directories, copy and record the value of Default Directory.
  5. Under API, copy and record the value of Token.
    Copy the required values from Qualtrics account.
  6. Click the OAuth Client Manager tab.
  7. Click Create Client.
  8. On the form, fill the values.
    Field Description
    Name Name to identify the client record.
    Scopes Select manage:all.
    Grant Type Select Client Credentials.
  9. Click Create Client.
    Copy and record the values of client ID and client secret.
    The values of Client ID and Client Secret are displayed. Copy and record these values for later use.

Configure a connection

Add and configure a Qualtrics connection to authenticate ServiceNow requests.

Before you begin

Role required: admin

Procedure

  1. Navigate to Process Automation > Flow Designer.
  2. Click the Connections tab.
  3. Locate the alias for Qualtrics and click View Details.
    Note: Don't click Add Connection.
    View connection details.
  4. If you are configuring the spoke for the first time, click Configure.
    Configure connection record.
  5. On the Configure Connection form, fill in the fields.
    FieldDescription
    Connection Name Name to identify the connection record.
    Connection URL Base URL to connect to Qualtrics. Enter: https:<Organization-ID>.qualtrics.com/API/v3
    X-API-TOKEN Unique token you had copied from the Qualtrics account settings.
    OAuth Name Name to identify the application registry record.
    OAuth Client ID Client ID you had copied when you created a client in your Qualtrics account.
    OAuth Client Secret Client Secret you had copied when you created a client in your Qualtrics account.
    Token URL OAuth server token endpoint. Enter: https://<Data-Center-ID>.qualtrics.com/oauth2/token.
    Note: Select the Qualtrics data center based on your geographic location.
  6. Click Configure and Get OAuth Token.

Result

The spoke is configured and ready to be used.

Configure system parameter

Configure the system parameter sn_qualtrics_spoke.qualtrics_directory and specify the Qualtrics Directory ID that can be used in the flows.

Before you begin

Role required: admin.

Procedure

  1. In the filter navigator, enter sys_properties.list.
  2. Search and open the record with Name as sn_qualtrics_spoke.qualtrics_directory.
  3. In Value, specify the Qualtrics Directory ID.
  4. Click Update.