> For the complete documentation index, see [llms.txt](https://ask.birdie.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/qualtrics.md).

# 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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/qualtrics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.