Chargebee
Manage Chargebee customers, subscriptions, invoices, items, and prices
Connect Chargebee when a project needs subscription billing data or must create and update customer records. Chargebee uses a site name and API key, so a Swarmz administrator controls whether the connector is visible and each workspace supplies its own credentials. No OAuth application is required.
Before you connect
In Chargebee, create an API key with only the access your project needs. Test and live Chargebee sites use different keys. Keep the key in the secure connector form; don't add it to chat, project files, or browser code.
You also need the site name from your Chargebee URL. For https://acme-test.chargebee.com, enter acme-test. Swarmz accepts a site name, not a complete URL, and sends requests only to that site's chargebee.com API origin.
See Chargebee API authentication for key creation and environment details.
Available operations
| Operation | What it does | Limit per minute |
|---|---|---|
list_customers, get_customer | Lists filtered customers or reads one customer | 30 |
create_customer, update_customer | Creates or updates one customer | 10 |
list_subscriptions, get_subscription | Lists subscriptions or reads one subscription | 30 |
create_subscription | Creates an item-based subscription for an existing customer | 10 |
list_invoices | Lists invoices by customer, subscription, or status | 30 |
list_items, list_item_prices | Lists product items and their prices | 30 |
Swarmz limits list pages to 100 records and response bodies to 2 MB. Write operations pause for AI approval during a build. The connector doesn't collect card or bank details; use Chargebee's hosted checkout or payment-source tools for payment information.
Connect Chargebee
- Ask the AI for the billing workflow and name the Chargebee records it should use. For example: “Use our shared Chargebee connection to show active subscriptions and the latest invoices for the signed-in customer.”
- In Settings > Integrations, select Chargebee, then select Connect new.
- Enter the Chargebee Site and API key in the secure form.
- Link the connection to the project when prompted.
For a write workflow, state the intended change: “Create a Chargebee customer from this form, then create a subscription using the selected item price.” The AI will request the connection when it reaches a supported Chargebee operation.
Verify Chargebee
- List customers and confirm a known test customer.
- List item prices and confirm the item price ID used by the project.
- Create a disposable customer on a Chargebee test site.
- Create a test subscription for that customer and confirm the generated invoice in Chargebee.
- Cancel or delete the disposable test data in Chargebee.
If validation fails, confirm that the site name doesn't include https:// or .chargebee.com, then check that the key belongs to the same test or live site. If reads work but a write fails, update the key's API access in Chargebee. Rotate a leaked key in Chargebee, then reconnect the Swarmz connection with the replacement.