> ## Documentation Index
> Fetch the complete documentation index at: https://docs.textql.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs Connector

> Query your ElevenLabs voices, generation history, and usage data directly in Ana.

### **1. Overview**

The Ana x ElevenLabs integration connects your ElevenLabs account to Ana, giving you natural language access to your voice library, text-to-speech generation history, models, and subscription usage. Once configured, Ana can summarize character consumption, break down generation history by voice or model, and inspect your voice library — all without leaving your workflow.

<Note>
  Connect ElevenLabs to Ana to query and analyze your voice generation activity and usage using natural language.
</Note>

### **2. Prerequisites**

You'll need:

* An ElevenLabs account (any paid or free tier with API access)
* A TextQL account with permission to add API connectors

### **3. Capabilities**

Once configured, Ana can:

* Summarize subscription usage: character quota consumed, remaining credits, and reset dates.
* Break down text-to-speech generation history by voice, model, and date.
* List and inspect the voices in your voice library, including labels and settings.
* Query available models and their capabilities.

### **4. Setup Instructions**

***

### Step 1: Create your ElevenLabs API key

1. Go to [elevenlabs.io](https://elevenlabs.io) and sign in.
2. Click **Developers** in the bottom-left corner of the dashboard.
3. Select the **API Keys** tab.
4. Click **+ Create Key**.
5. Configure the key:
   * **Permissions**: select the endpoints Ana should access. At minimum, include **User** read access (required for the connection test), plus History, Voices, and Models for the capabilities above.
   * **Credit limit**: optionally set a monthly credit cap to prevent unexpected usage.
6. Copy the API key immediately — ElevenLabs shows the full key only once, at creation.

### **Step 2: Add ElevenLabs as an API connector in TextQL**

1. Go to app.textql.com and sign in.
2. In the bottom left sidebar, click **Connectors > APIs** and select ElevenLabs.
3. In the configuration panel, fill in the fields:
   * Name (e.g. `ElevenLabs`)
   * API Key: paste the key copied from Step 1
4. Click **Test** to verify the key, then click **Save**.

### **Step 3: Verify the connection**

1. Go to app.textql.com.

2. Click on the Elevenlabs connector and select Test Connection at the bottom of the panel.

* A successful setup will return Connection successful (200).
* If the test fails, refer to the [Troubleshooting](#6-troubleshooting) section for next steps.

***

### **5. Usage Examples**

Once configured, you can ask Ana:

* "How much of my ElevenLabs character quota is left this month?"
* "Break down my TTS generations by voice over the last 30 days."
* "Which model did I use most for speech generation this week?"
* "List the voices in my voice library with their labels."
* "When does my ElevenLabs usage quota reset?"

### **6. Troubleshooting**

| **Symptom**                    | **Likely Cause**                                                                           | **Fix**                                                                                            |
| ------------------------------ | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| Test fails with 401            | Invalid, revoked, or incorrectly copied API key                                            | Create a new key under **Developers → API Keys** and update the connector in TextQL.               |
| Test fails despite a valid key | The key's permissions exclude the **User** endpoint (the connection test calls `/v1/user`) | Edit the key's permissions in ElevenLabs to include User read access, or create a new key with it. |
| 401 on specific queries only   | The key is scoped to a subset of endpoints                                                 | Add the missing endpoint permissions (History, Voices, Models) to the key.                         |
| Quota errors (429)             | The key's monthly credit limit is exhausted                                                | Raise the key's credit limit or wait for the monthly reset.                                        |

### **7. Security Notes**

* Follow the principle of least privilege: scope the key to only the endpoints Ana needs, and set a credit limit.
* API keys are shown in full only once. Store them securely and never share them in email, chat, or tickets.
* Rotate the key if you suspect it has been exposed — keys remain valid until deleted.
* If you no longer need the integration, delete the key under **Developers → API Keys** and remove the connector from TextQL.
* For more details, refer to [ElevenLabs' authentication documentation](https://elevenlabs.io/docs/api-reference/authentication).

***

### **Need Help?**

For further assistance, please contact [support@textql.com](mailto:support@textql.com).

### **Privacy Policy**

For information about how we handle your data and protect your privacy, please review our [Privacy Policy](https://textql.com/privacy).