Chargebee
Read and write Chargebee customers, subscriptions, item families, items, item prices and coupons; read invoices, credit notes, transactions, usage, quotes and events.
Keep subscription billing in Chargebee aligned with CRM, ERP, product usage and revenue systems without manual exports.
Source actions
26
Destination actions
14
Data types
15
Validation status
Implemented · fixture tested.
Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.
What you can map
attached items
- List attached items of an itemSourceIncremental
Attached items of an item with offset pagination and incremental updated_at[after].
attached_items.list
coupons
- Create couponDestinationProvider duplicate protectionApproval before production
Creates a coupon for items (create_a_coupon_for_items).
coupons.create - Get couponSource
One coupon by ID.
coupons.get - List couponsSourceIncremental
Coupons with offset pagination and incremental updated_at[after].
coupons.list - Update couponDestinationProvider duplicate protectionApproval before production
Updates a coupon for items (update_a_coupon_for_items).
coupons.update
credit notes
- Get credit noteSource
One credit note by ID.
credit_notes.get - List credit notesSourceIncremental
Credit notes with offset pagination and incremental updated_at[after].
credit_notes.list
customer contacts
- List contacts of a customerSource
Contacts of a customer with offset pagination.
customer_contacts.list
customers
- Create customerDestinationProvider duplicate protectionApproval before production
Creates a customer with billing address, custom fields and metadata.
customers.create - Get customerSource
One customer by ID.
customers.get - List customersSourceIncremental
Customers with offset pagination and incremental updated_at[after].
customers.list - Update customerDestinationProvider duplicate protectionApproval before production
Updates supplied customer fields. Billing address changes use Chargebee's billing info endpoint and are not included.
customers.update
events
- Get eventSource
One event by ID.
events.get - List eventsSourceIncremental
Events with offset pagination.
events.list
invoices
- Create pending invoiceDestinationProvider duplicate protectionApproval before production
Creates a pending invoice for a subscription from item prices and one-time charges. No payment is collected.
invoices.create - Get invoiceSource
One invoice by ID.
invoices.get - List invoicesSourceIncremental
Invoices with offset pagination and incremental updated_at[after].
invoices.list
item families
- Create item familyDestinationProvider duplicate protectionApproval before production
Creates an item family that groups plans, addons and charges.
item_families.create - Get item familySource
One item family by ID.
item_families.get - List item familiesSourceIncremental
Item families with offset pagination and incremental updated_at[after].
item_families.list - Update item familyDestinationProvider duplicate protectionApproval before production
Updates an item family name or description.
item_families.update
item prices
- Create item priceDestinationProvider duplicate protectionApproval before production
Creates a price point for an item with pricing model, period and optional tiers.
item_prices.create - Get item priceSource
One item price by ID.
item_prices.get - List item pricesSourceIncremental
Item prices with offset pagination and incremental updated_at[after].
item_prices.list - Update item priceDestinationProvider duplicate protectionApproval before production
Updates supplied item price fields. Archiving is not automated.
item_prices.update
items
- Create itemDestinationProvider duplicate protectionApproval before production
Creates a plan, addon or charge item in an item family.
items.create - Get itemSource
One item by ID.
items.get - List items (plans, addons and charges)SourceIncremental
Items (plans, addons and charges) with offset pagination and incremental updated_at[after].
items.list - Update itemDestinationProvider duplicate protectionApproval before production
Updates supplied item fields. Archiving is not automated.
items.update
quotes
- Get quoteSource
One quote by ID.
quotes.get - List quotesSourceIncremental
Quotes with offset pagination and incremental updated_at[after].
quotes.list
subscriptions
- Create subscriptionDestinationProvider duplicate protectionApproval before production
Creates a subscription for an existing customer from item prices (create_subscription_for_items). Immediate charges are added to unbilled charges.
subscriptions.create - Get subscriptionSource
One subscription by ID.
subscriptions.get - List subscriptionsSourceIncremental
Subscriptions with offset pagination and incremental updated_at[after].
subscriptions.list - Update subscriptionDestinationProvider duplicate protectionApproval before production
Updates subscription items, coupons and terms (update_subscription_for_items). Supplied items are merged unless replaceItemsList is true.
subscriptions.update
transactions
- Get transactionSource
One transaction by ID.
transactions.get - List transactions (payments and refunds, read only)SourceIncremental
Transactions (payments and refunds, read only) with offset pagination and incremental updated_at[after].
transactions.list
unbilled charges
- List unbilled chargesSource
Unbilled charges with offset pagination.
unbilled_charges.list
usages
- Record usageDestinationProvider duplicate protectionApproval before production
Records usage for a metered item price on a subscription.
usages.create - List usage recordsSourceIncremental
Usage records with offset pagination and incremental updated_at[after].
usages.list
Authentication
Chargebee API key (HTTP Basic username)
Plans and access
All Chargebee plans include API access with full-access or read-only API keys. API keys are per site. Product Catalog 2.0 (items and item prices) is required; Product Catalog 1.0 plans and addons are not covered.
Test environment
Every Chargebee account has a test site ({site}-test.chargebee.com).
Rate limits
Per-site request limits depend on the Chargebee plan and are lower on test sites; Chargebee returns HTTP 429 when exceeded and Nexra backs off.
Pagination
limit (max 100) and offset, continued with next_offset from the response.
Provider events
Chargebee webhooks deliver event objects (for example subscription_created). Nexra event triggers are not yet available; flows run on demand or on a schedule.
Before you build a flow
- Subscription create and update always send invoice_immediately=false, so charges raised by the call go to unbilled charges and are invoiced on the next billing cycle instead of being charged during the flow.
- Invoice create always sets create_pending_invoice=true: Chargebee creates a pending invoice that collects no payment and requires usage-based billing to be enabled on the site and a subscription ID.
- Usage records are recorded against metered item prices and are billed by Chargebee on the next invoice.
- Cancellations, pauses, deletes, voids, write-offs, refunds, payment collection, recorded payments, payment sources and hosted pages are intentionally not automated.
- Archiving items, item prices or coupons (status changes) is not automated.
- Credit notes, transactions, quotes, unbilled charges and events are read only.
- Item constraints on coupons support constraint and item type; specific item price lists must be edited in Chargebee.
- Product Catalog 1.0 (plans and addons) endpoints are not covered.
Developer reference
- Create the Chargebee credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Chargebee, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/chargebee and the Connections API.