> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ecommerce/chargebee/faq.md).

# FAQ

<details>

<summary>Where do I find my Chargebee API key?</summary>

Log into your Chargebee dashboard and go to **Settings > Configure Chargebee > API Keys & Webhooks**. You'll see existing keys listed there. Click **Add API Key** to create a new one. For Coupler.io, a read-only key is sufficient and recommended.

</details>

<details>

<summary>What is the Chargebee site name and where do I find it?</summary>

Your site name is the subdomain in your Chargebee URL. For example, if your Chargebee dashboard is at `acme-test.chargebee.com`, your site name is `acme-test`. Enter only the subdomain — not the full URL.

</details>

<details>

<summary>Can I export data from multiple Chargebee sites?</summary>

Yes. Create a data flow with sources pointing to each site using separate API keys. Use Coupler.io's **Append** transformation to combine data from both sites into a single dataset, with a column to distinguish which site each record came from.

</details>

<details>

<summary>Why are my revenue numbers 100x too large?</summary>

Chargebee stores all monetary values in the smallest currency unit (cents for USD/EUR). Divide those fields by 100 to get standard decimal amounts. Apply this conversion in your destination — for example, as a calculated column in Google Sheets or a transformation in BigQuery.

</details>

<details>

<summary>Why do dates appear as large numbers instead of readable dates?</summary>

Chargebee returns timestamps as Unix epoch integers. You'll need to convert them in your destination. In Google Sheets, use `=(A1/86400)+DATE(1970,1,1)`. In BigQuery, use `TIMESTAMP_SECONDS(field_name)`.

</details>

<details>

<summary>Should I use Plans/Addons or Items/Item prices?</summary>

It depends on which version of Chargebee's Product Catalog your account uses. If you created your Chargebee account recently or have migrated, you're likely on Product Catalog v2 — use **Items**, **Item prices**, and **Item families**. Legacy accounts use **Plans** and **Addons**. Mixing entities from both versions in the same report will cause mismatches.

</details>

<details>

<summary>Can I use Chargebee data with AI tools?</summary>

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can send Chargebee subscription or invoice data directly to these tools for automated analysis, narrative summaries, or anomaly detection.

</details>

<details>

<summary>My data flow keeps failing with an internal error — what should I check?</summary>

Start by verifying your API key is valid and hasn't been revoked in Chargebee. Also confirm your site name is correct (subdomain only, no `.chargebee.com`). If credentials look right, try creating a fresh API key in Chargebee and updating your data flow. See the Common Issues article for more detail.

</details>

{% hint style="info" %}
For details on available fields and how to combine entities, see the [Data Overview](/sources/category/ecommerce/chargebee/data-overview.md) article. For troubleshooting sync failures, visit [Common Issues](/sources/category/ecommerce/chargebee/common-issues.md). For setup recommendations, check [Best Practices](/sources/category/ecommerce/chargebee/best-practices.md).
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/ecommerce/chargebee/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.