Skip to main content

Authorization

Follow this guide to create a new Qualtrics credential that will allow Nexla to authenticate to and exchange data with your Qualtrics account.
qualtrics_api_auth.png

Qualtrics

Prerequisites​

Before creating a Qualtrics credential, you need to obtain your API token and identify your datacenter hostname from your Qualtrics account. Qualtrics uses API token authentication for all API requests, with the API token sent in the X-API-TOKEN header.

To obtain your Qualtrics API credentials, follow these steps:

  1. Sign in to your Qualtrics account using your administrator credentials.

  2. Navigate to your account settings in the Qualtrics interface.

  3. Look for the Account Settings section, then navigate to Qualtrics IDs or API section.

  4. Your API Token will be displayed in the Qualtrics IDs section. Copy the API token immediately, as it may not be accessible again after you navigate away from the page.

  5. Your Datacenter Hostname will also be displayed in the Qualtrics IDs section. The datacenter hostname is typically in the format <yourdatacenterid>.qualtrics.com (e.g., fra1.qualtrics.com, iad1.qualtrics.com). Copy the datacenter hostname.

  6. Store both the API token and datacenter hostname securely, as you will need them to configure your Nexla credential. The API token is sensitive information and should be kept confidential.

The API token is sent in the X-API-TOKEN header for all API requests to the Qualtrics API. The datacenter hostname determines which Qualtrics datacenter your API requests will be sent to. The API token authenticates your requests and grants access to Qualtrics resources based on your account permissions. If your API token is compromised, you should immediately regenerate it in your Qualtrics account settings. For detailed information about obtaining API tokens, datacenter hostnames, API authentication, and available endpoints, refer to the Qualtrics API documentation and Base URL and Datacenter IDs documentation.

Create a Qualtrics Credential​

  • To create a new Qualtrics credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Qualtrics

QualtricsCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Token Authentication​

Qualtrics uses API token authentication for all API requests. The API token is sent in the X-API-TOKEN header to authenticate API requests to the Qualtrics API.

  1. Enter your Qualtrics datacenter hostname in the Qualtrics Datacenter Hostname field. This should be your datacenter hostname in the format <yourdatacenterid>.qualtrics.com (e.g., fra1.qualtrics.com, iad1.qualtrics.com). The datacenter hostname determines which Qualtrics datacenter your API requests will be sent to. You can find your datacenter hostname in your Qualtrics account settings under Account Settings > Qualtrics IDs.

  2. Enter your Qualtrics API token in the API Token field. This is the API token you obtained from your Qualtrics account settings (Account Settings > Qualtrics IDs). The API token is sent in the X-API-TOKEN header for all API requests to the Qualtrics API. The API token is sensitive information and must be kept confidential.

    Your Qualtrics API token can be found in your Qualtrics account settings under Account Settings > Qualtrics IDs. The API token is sent in the X-API-TOKEN header for all API requests to the Qualtrics API. The datacenter hostname should match your Qualtrics datacenter hostname, which can also be found in your Qualtrics account settings under Account Settings > Qualtrics IDs.

    If your API token is compromised, you should immediately regenerate it in your Qualtrics account settings. The API token provides access to your Qualtrics account data and should be treated as sensitive information. Keep your API token secure and do not share it publicly.

    For detailed information about obtaining API tokens, datacenter hostnames, API authentication, and available endpoints, see the Qualtrics API documentation and Base URL and Datacenter IDs documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.