FAQ

Where do I find my Chargebee API key?

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.

What is the Chargebee site name and where do I find it?

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.

Can I export data from multiple Chargebee sites?

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.

Why are my revenue numbers 100x too large?

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.

Why do dates appear as large numbers instead of readable dates?

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

Should I use Plans/Addons or Items/Item prices?

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.

Can I use Chargebee data with AI tools?

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.

My data flow keeps failing with an internal error — what should I check?

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.

For details on available fields and how to combine entities, see the Data Overview article. For troubleshooting sync failures, visit Common Issues. For setup recommendations, check Best Practices.