# Qualtrics

### Overview

Birdie integrates with Qualtrics to ingest survey responses and their related attributes (linked contact data) into your Birdie workspace. This allows you to centralize customer feedback from Qualtrics alongside other sources and analyze it with Birdie AI.

### Requirements

To enable the integration, you will need:

* An active [Qualtrics](https://qualtrics.com/) account with API access.
* Either an OAuth Authentication (Client Credentials Grant) or an API Token (explained below).

### Setup in Qualtrics

#### Option 1 (Recommended): OAuth Authentication (Client Credentials)

OAuth Authentication is the recommended method if you want secure access managed by Qualtrics. Client Credentials Grant is intended for server-to-server communication, where no user interaction is needed.

{% stepper %}
{% step %}

#### Accessing your Qualtrics account

* Log in to your Qualtrics account and go to **Account Settings**.
* Select **OAuth Client Manager**.
* Click **Create Client**.

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/Wv-hcl7e2N.png)
{% endstep %}

{% step %}

#### Create an OAuth Client in Qualtrics

* Fill in the name and contact information for the client.
* Under Scopes, select the required API scopes that allow Birdie to **read** surveys and related metadata:
  * read:survey\_responses
  * read:surveys

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/mCGmmzHBPa.png)

* In Grant Type, select **Client Credentials**.
* Click **Create Client**.

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/lvGKHRjKMa.png)

{% hint style="warning" %}
Copy and save the generated **Client ID** and **Client Secret**. They will only be shown once.
{% endhint %}

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/gE8fGhlADY.png)
{% endstep %}

{% step %}

#### Provide Credentials to Birdie

Share [securely](https://onetimesecret.com/en/) with Birdie:

* Client ID
* Client Secret
* Data Center URL (This data center is visible in your Qualtrics URL. Example: <https://iad1.qualtrics.com>)

{% hint style="warning" %}
Once you exit out of this window, the Client Secret is <mark style="color:$warning;">**irretrievable**</mark>. If you lose or forget your **Client Secret,** you will need to repeat the above process to generate a new one.
{% endhint %}
{% endstep %}
{% endstepper %}

#### Option 2: Connect via API Token

If OAuth is not available, you can connect using a Qualtrics API Token.

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/0r1uh3lMFO.png)

{% stepper %}
{% step %}

#### Retrieve Your API Token

* Log in to Qualtrics.
* Go to Account Settings (via the user dropdown).
* Open the Qualtrics IDs section.
* Click **Generate Token** (if you don’t already have one).

{% hint style="warning" %}
Generating a new token will replace the old one <mark style="color:$warning;">**immediately**</mark>. Any existing integrations using the old token will stop working until updated.
{% endhint %}

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/D_Ws7R2cVz.png)
{% endstep %}

{% step %}

#### Provide Credentials to Birdie

Share [securely](https://onetimesecret.com/en/) with Birdie:

* API Token
* Data Center URL (This data center is visible in your Qualtrics URL. Example: <https://iad1.qualtrics.com>)

{% hint style="info" %}
Key Rotation Best Practices:

* Rotate your API token regularly (at least once per year).
* Consider migrating to **OAuth Authentication**, which provides automatic token expiry and reduces downtime risks.
  {% endhint %}
  {% endstep %}
  {% endstepper %}

### Connect to Birdie

After you’ve generated either OAuth client credentials or an API Token and shared them securely, the Birdie team will configure the connector and confirm once the integration is active.

### Data in scope

Once configured, the Qualtrics integration imports survey responses and their related attributes (such as contact data) from the projects you connect, so they can be analyzed alongside your other feedback sources in Birdie.

### References

* [Getting Started with the Qualtrics API](https://www.qualtrics.com/support/integrations/api-integration/overview/)
  * [Generating an API Token](https://www.qualtrics.com/support/integrations/api-integration/overview/#GeneratingAnAPIToken)