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

# ElevenLabs Billing Setup

> Connect ElevenLabs workspace usage to Costory with a workspace API key. Import voice and audio spend into Explorer next to AWS, GCP, and Azure.

ElevenLabs workspace usage sits on a separate bill from AWS, GCP, and Azure. Connect with a **workspace API key** so that spend lands in <Tooltip tip="Costory's main interface for exploring cloud costs across all connected providers." cta="See Glossary" href="/docs/glossary#cost-explorer">Explorer</Tooltip> with your other [billing datasources](/setup/billing).

This connector imports workspace **usage** from the [usage query API](https://elevenlabs.io/docs/api-reference/analytics/workspace/usage). Costory stores it as a billing datasource, the same as other SaaS billing sources.

<Tabs>
  <Tab title="Manual setup">
    <Steps>
      <Step title="Create a workspace API key">
        In [ElevenLabs > Developers / API keys](https://elevenlabs.io/app/settings/api-keys), create a **workspace API key** (typically `sk_...`). Copy it immediately. It is shown once.
      </Step>

      <Step title="Grant Workspace analytics, full read">
        Grant **Workspace analytics, full read** (`workspace_analytics_full_read`). Restrict the key to analytics if the UI allows. A key without this scope cannot ingest usage.
      </Step>

      <Step title="Connect in Costory">
        Go to [Integrations](https://app.costory.io/integration), click **+ Add integration**, then choose **ElevenLabs** under **Billing**. The connect URL is `/integration/new/elevenlabs/billing`.&#x20;
      </Step>

      <Step title="Enter connection details">
        Fill **Connection name** (default **ElevenLabs**) and **API token**.

        **Region** is optional and only needed for isolated residency hosts. Leave it on **Global** (`api.elevenlabs.io`) unless this workspace lives on a residency host. The wrong region looks like a bad key. See ElevenLabs [data residency](https://elevenlabs.io/docs/overview/administration/data-residency).

        | Region in Costory    | API host                         |
        | -------------------- | -------------------------------- |
        | **Global** (default) | `api.elevenlabs.io`              |
        | **US**               | `api.us.elevenlabs.io`           |
        | **EU**               | `api.eu.residency.elevenlabs.io` |
        | **India**            | `api.in.residency.elevenlabs.io` |
        | **Singapore**        | `api.sg.residency.elevenlabs.io` |

        **Start date** is optional. Leave it empty to use Costory's default lookback.
      </Step>

      <Step title="Validate, then save">
        Click **Validate**. Costory calls the workspace usage query with `xi-api-key`. **Save** stays disabled until the key can read workspace usage. An empty usage window is still success. If this is the only billing source and it is demo data, Costory asks you to confirm before replacing it.
      </Step>
    </Steps>

    On first sync, Costory backfills up to **12 months** of workspace usage, depending on what ElevenLabs retains. New data then follows the usual [data refresh](/docs/data-refresh) cadence. SaaS sources typically appear in about **10 minutes**.
  </Tab>

  <Tab title="Terraform">
    Not supported yet.
  </Tab>
</Tabs>

## Field reference

| Field               | Required | Description                                                                                           |
| ------------------- | -------- | ----------------------------------------------------------------------------------------------------- |
| **Connection name** | Yes      | Label in **Integrations**.                                                                            |
| **API token**       | Yes      | Workspace key (`sk_...`) with **Workspace analytics, full read**. Stored in Costory's secret manager. |
| **Region**          | No       | Global by default. Set US, EU, India, or Singapore only for isolated residency workspaces.            |
| **Start date**      | No       | Optional start of the first sync. Leave empty for the default lookback.                               |

## What Costory includes

Costory pulls workspace usage from ElevenLabs' [Get workspace usage](https://elevenlabs.io/docs/api-reference/analytics/workspace/usage) API and maps it into <Tooltip tip="Costory's unified billing schema: the same dimensions everywhere (Provider, Billing account id, Service name, SKU ID, Region, Category, and more). In SQL and exports, column names use a cos_ prefix (for example cos_service_name)." cta="See Glossary" href="/docs/glossary#standard-columns">Standard Columns</Tooltip>.

Typical lines are billed workspace usage by product over time for that account.

**How to analyze ElevenLabs costs**

* Spend by product: group by **Service name** or **SKU**
* Spend over time: use the same date presets as other billing sources in Explorer

**What Costory does not include**

* Per-voice (`voice_id`) or per-member email splits
* Taxes, credits, or invoice adjustments outside the usage query
* Inference keys that are not workspace API keys

<Info>
  Rotate the API token from **Integrations** when you need a new credential. The stored region stays the same. A residency move is a different workspace and key: create a new datasource.
</Info>

## Troubleshooting

| Issue                                     | What to check                                                                                                                                                                   |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Failed to authenticate                    | Paste a **workspace API key** (`sk_...`), not a user or project inference key. Confirm **Region** matches the workspace residency.                                              |
| Access denied                             | Grant **Workspace analytics, full read** (`workspace_analytics_full_read`). Restrict the key to analytics if the UI allows.                                                     |
| Usage analytics endpoint not found        | Confirm the key and region (global vs US / EU / India / Singapore). Isolated residency workspaces are separate accounts.                                                        |
| Validation succeeds but Explorer is empty | Wait for the first sync (about 10 minutes). Check the datasource date range on [Integrations](https://app.costory.io/integration). A brand-new workspace can have no usage yet. |

## Related pages

<CardGroup cols={2}>
  <Card title="Billing Data" icon="database" href="/setup/billing">
    All billing providers and shared setup notes.
  </Card>

  <Card title="Kling AI billing" icon="film" href="/setup/billing/kling-ai">
    Connect Kling Open Platform unit deductions.
  </Card>

  <Card title="OpenAI billing" icon="robot" href="/setup/billing/openai">
    Import OpenAI Platform organization costs.
  </Card>

  <Card title="Explorer" icon="chart-line" href="/features/cost-explorer">
    Filter and group ElevenLabs spend with the rest of your stack.
  </Card>
</CardGroup>