Zuora
Keep Zuora in step with your orders, invoices and payments without re-keying, with the right person approving what changes.
48 ways to read, 14 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Zuora, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create accountApproval by rule
- Create contactApproval by rule
- List customer accountsRead
Example flow
- Zuora · List customer accountsDone
- Zuora · Create accountNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Zuora.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Zuora
- Zuora's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a Zuora test account before you go live.
For developers
Technical detail
Zuora accounts, contacts, subscriptions, catalogue (products, plans, charges and tiers), draft invoices, usage, amendments, orders, memos, payments, refunds, taxes, bill runs and payment runs.
Zuora API docs- Source actions
- 48
- Destination actions
- 14
- Data types
- 25
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Account summaries1
- Get account summarySource
One account's balance, contacts and its most recent subscriptions, invoices, payments and usage.
Accounts4
- Create accountDestinationProvider duplicate protectionApproval before production
Creates a customer account with a bill-to contact. autoPay is always false.
- Get customer accountSource
One customer account by ID or number through the Object Query API.
- List customer accountsSourceIncremental
Customer accounts through the Object Query API with cursor pagination and incremental updateddate filtering.
- Update accountDestinationProvider duplicate protectionApproval before production
Updates supplied account fields. Payment settings are not changed.
Amendments2
- Get amendmentSource
One amendment by ID or number through the Object Query API.
- List subscription amendmentsSourceIncremental
Subscription amendments through the Object Query API with cursor pagination and incremental updateddate filtering.
Bill runs2
- Get bill runSource
One bill run by ID or number through the Object Query API.
- List bill runs (read only)SourceIncremental
Bill runs (read only) through the Object Query API with cursor pagination and incremental updateddate filtering.
Contacts4
- Create contactDestinationProvider duplicate protectionApproval before production
Creates a contact on an account.
- Get contactSource
One contact by ID or number through the Object Query API.
- List contactsSourceIncremental
Contacts through the Object Query API with cursor pagination and incremental updateddate filtering.
- Update contactDestinationProvider duplicate protectionApproval before production
Updates supplied contact fields.
Credit memo items2
- Get credit memo itemSource
One credit memo item by ID or number through the Object Query API.
- List credit memo itemsSourceIncremental
Credit memo items through the Object Query API with cursor pagination and incremental updateddate filtering.
Credit memos2
- Get credit memoSource
One credit memo by ID or number through the Object Query API.
- List credit memosSourceIncremental
Credit memos through the Object Query API with cursor pagination and incremental updateddate filtering.
Debit memo items2
- Get debit memo itemSource
One debit memo item by ID or number through the Object Query API.
- List debit memo itemsSourceIncremental
Debit memo items through the Object Query API with cursor pagination and incremental updateddate filtering.
Debit memos2
- Get debit memoSource
One debit memo by ID or number through the Object Query API.
- List debit memosSourceIncremental
Debit memos through the Object Query API with cursor pagination and incremental updateddate filtering.
Invoice items1
- List invoice itemsSourceIncremental
Invoice items through the Object Query API with cursor pagination and incremental updateddate filtering.
Invoices3
- Create draft invoiceDestinationProvider duplicate protectionApproval before production
Creates a standalone invoice in Draft status with invoice items. Nothing is posted or collected.
- Get invoiceSource
One invoice by ID or number through the Object Query API.
- List invoicesSourceIncremental
Invoices through the Object Query API with cursor pagination and incremental updateddate filtering.
Order actions2
- Get order actionSource
One order action by ID or number through the Object Query API.
- List order actions (read only)SourceIncremental
Order actions (read only) through the Object Query API with cursor pagination and incremental updateddate filtering.
Orders2
- Get orderSource
One order by ID or number through the Object Query API.
- List orders (read only)SourceIncremental
Orders (read only) through the Object Query API with cursor pagination and incremental updateddate filtering.
Payment runs2
- Get payment runSource
One payment run by ID or number through the Object Query API.
- List payment runs (read only)SourceIncremental
Payment runs (read only) through the Object Query API with cursor pagination and incremental updateddate filtering.
Payments2
- Get paymentSource
One payment by ID or number through the Object Query API.
- List payments (read only)SourceIncremental
Payments (read only) through the Object Query API with cursor pagination and incremental updateddate filtering.
Product rate plan charge tiers2
- Get product rate plan charge tierSource
One product rate plan charge tier by ID or number through the Object Query API.
- List product rate plan charge tiers (prices)SourceIncremental
Product rate plan charge tiers (prices) through the Object Query API with cursor pagination and incremental updateddate filtering.
Product rate plan charges4
- Create product rate plan chargeDestinationProvider duplicate protectionApproval before production
Creates a charge (price) on a product rate plan with its price tiers (CRUD object API).
- Get product rate plan chargeSource
One product rate plan charge by ID or number through the Object Query API.
- List product rate plan chargesSourceIncremental
Product rate plan charges through the Object Query API with cursor pagination and incremental updateddate filtering.
- Update product rate plan chargeDestinationProvider duplicate protectionApproval before production
Updates a product rate plan charge and replaces its price tiers (CRUD object API).
Product rate plans4
- Create product rate planDestinationProvider duplicate protectionApproval before production
Creates a rate plan on a product (CRUD object API). Charges are configured in Zuora.
- Get product rate planSource
One product rate plan by ID or number through the Object Query API.
- List product rate plansSourceIncremental
Product rate plans through the Object Query API with cursor pagination and incremental updateddate filtering.
- Update product rate planDestinationProvider duplicate protectionApproval before production
Updates supplied rate plan fields (CRUD object API).
Products4
- Create productDestinationProvider duplicate protectionApproval before production
Creates a catalogue product (CRUD object API).
- Get productSource
One product by ID or number through the Object Query API.
- List productsSourceIncremental
Products through the Object Query API with cursor pagination and incremental updateddate filtering.
- Update productDestinationProvider duplicate protectionApproval before production
Updates supplied product fields (CRUD object API).
Rate plan charges2
- Get subscription rate plan chargeSource
One subscription rate plan charge by ID or number through the Object Query API.
- List subscription rate plan chargesSourceIncremental
Subscription rate plan charges through the Object Query API with cursor pagination and incremental updateddate filtering.
Rate plans2
- Get subscription rate planSource
One subscription rate plan by ID or number through the Object Query API.
- List subscription rate plansSourceIncremental
Subscription rate plans through the Object Query API with cursor pagination and incremental updateddate filtering.
Refunds2
- Get refundSource
One refund by ID or number through the Object Query API.
- List refunds (read only)SourceIncremental
Refunds (read only) through the Object Query API with cursor pagination and incremental updateddate filtering.
Subscriptions4
- Create subscriptionDestinationProvider duplicate protectionApproval before production
Creates a subscription for an account from product rate plans. No billing run or payment collection is triggered.
- Get subscriptionSource
One subscription by ID or number through the Object Query API.
- List subscriptionsSourceIncremental
Subscriptions through the Object Query API with cursor pagination and incremental updateddate filtering.
- Update subscriptionDestinationNot retried automaticallyApproval before production
Adds, updates or changes rate plans and updates term and renewal settings. No billing run or payment collection is triggered.
Taxation items2
- Get taxation itemSource
One taxation item by ID or number through the Object Query API.
- List taxation itemsSourceIncremental
Taxation items through the Object Query API with cursor pagination and incremental updateddate filtering.
Usages3
- Create usage recordDestinationNot retried automaticallyApproval before production
Creates one usage record against an account and, optionally, a subscription charge (CRUD object API). Zuora rates it on the next bill run.
- Get usage recordSource
One usage record by ID or number through the Object Query API.
- List usage recordsSourceIncremental
Usage records through the Object Query API with cursor pagination and incremental updateddate filtering.
Access and limits
- Authentication
- Zuora OAuth client (client credentials)
- Plans and access
- Available to Zuora Billing tenants; Object Query requires a tenant on a current release. Calls run as the OAuth client's API user and follow that user's Zuora role. Multi-entity tenants must scope the OAuth client to one entity.
- Test environment
- Zuora provides API Sandbox and Developer & Central Sandbox tenants on separate hosts.
- Rate limits
- Zuora applies per-tenant request and concurrency limits and returns HTTP 429 with RateLimit headers; Nexra backs off and retries reads.
- Pagination
- Object Query pageSize (max 99) with cursor from nextPage.
- Provider events
- Zuora callout notifications for account, subscription, invoice and payment events. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Lists use the Object Query API; filters are combined with AND and updateddate.GT is used for incremental reads.
- Subscription create and update always send runBilling=false and collect=false, so no invoice is generated and no payment is collected during the flow.
- Subscription update supports add, update and change rate plan actions and term settings; removing rate plans, cancel, suspend, resume, renew and delete are not automated. Repeated updates are not deduplicated because Zuora only honours Idempotency-Key on POST and PATCH.
- Account create always sends autoPay=false and never sends payment methods or credit cards.
- Invoice create always creates standalone invoices with status Draft and autoPay=false; posting, emailing, cancelling, reversing and write-offs are not automated.
- Credit memos, debit memos, memo items, payments, refunds, invoice items, taxation items, amendments, orders, order actions and bill runs are read only; payment creation, refunds, applications, transfers, memo creation, posting and collection are not automated.
- Usage records are created one at a time through the CRUD usage object. They are billable-adjacent (Zuora rates them on the next bill run), so the operation is marked billable and never retried; supply uniqueKey to let Zuora reject duplicates.
- Product rate plan charges are created and updated through the CRUD object API with the documented core fields and price tiers. Zuora's update replaces every tier, so send the full tier list. Prepaid, drawdown, commitment and dynamic-pricing charge settings are not offered.
- Usage upload (CSV import), Orders API writes (create, activate, cancel), order previews, payment methods and the Commerce catalog API are not covered. Payment-method data is outside the allowed read scope.
- Account summaries return Zuora's recent subscriptions, invoices, payments and usage for one account (Zuora caps each list).
- Zuora can return HTTP 200 with success:false; Nexra classifies these by the error code's two-digit category suffix.
- Payouts and settlements: Zuora is a billing platform and does not pay out funds, so it has no payout or settlement list. Payouts, settlement lines and processor fees come from the payment gateway (for example Stripe, Adyen or Braintree), which is connected separately. When Zuora gateway reconciliation is used, payments and refunds carry the gateway payoutId and reconciliation status.
- Processor fees: Zuora payment and refund records carry no fee amounts; read fees from the payment gateway connected separately.
- Disputes and chargebacks: Zuora's API has no dispute or chargeback object; read disputes from the payment gateway connected separately.
- Payment runs are read only; creating, updating or cancelling payment runs (which collect payments) is not automated.
Developer reference
- Create the Zuora credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Zuora, 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/zuora and the Connections API.