Create and import customer accounts
This topic explains about creating customer accounts in Zuora, add bill-to contacts, and set a default payment method. Note limitations on account names and VAT ID usage.
You can add customer accounts to Zuora Billing individually or in bulk, depending on your business workflow and volume:
Create individual accounts: Add single accounts manually in the Zuora UI or programmatically using REST or SOAP APIs. This method is ideal for ongoing, event-driven customer sign-ups or ad-hoc account creation.
REST API: For information, see post_account
SOAP API: For information, see account
Import accounts in bulk: Upload CSV files via the Zuora Data Loader to create multiple accounts, contacts, and payment methods simultaneously. This method is recommended for initial data onboarding, bulk migrations from CRM/ERP systems (such as Salesforce, NetSuite, or QuickBooks), or large batch updates.
Account creation methods
If you are using Avalara, you can specify a European Union Value Added Tax identification number for a customer account. To add an EU VAT ID to a customer account, enter an identification number in the VAT ID field when you create the customer account.
|
Method |
Best for |
Key prerequisites & details |
|---|---|---|
|
Zuora UI |
One-off customer accounts or testing |
Requires basic account details and at least one Bill To contact. |
|
REST / SOAP API |
Automated provisioning from external sign-up portals, e-commerce checkouts, or backend workflows. |
Requires API credentials and access to the Create an account REST operation or SOAP |
|
CSV Data Loader Import |
High-volume migration or batch data onboarding. |
Two-step process: import draft accounts with CSV templates, then import associated contacts and activate accounts. |
|
Account with Subscription | Creating a customer account and their initial subscription in a single unified workflow . |
Can be completed through Orders in the UI or via the Create an order API. |
Key considerations before adding customer accounts
Before creating or importing customer accounts, review the following guidelines and field constraints:
-
Character encoding limitations: 4-byte UTF-8 characters (such as certain emojis and uncommon symbols) are not supported in account names or contact first and last names
-
Contact requirements: Every active customer account must have at least one valid Bill To contact. You can optionally configure Sold To and Ship To contacts.
-
Account numbering: If you do not provide a custom account number, Zuora Billing automatically generates a unique account number
-
Batch assignment: You can organize accounts into batches (up to 50 batches) to segment bill runs and payment runs by region, billing cycle, or customer type .
-
European Union VAT ID (Early Adopter): If you use Avalara for tax calculation, you can specify an EU VAT identification number in the VAT ID field during account creation. To enable this feature, contact Zuora Global Support.