Creates an account without creating any associated objects such as subscriptions.
Idempotency-Key | string <= 255 characters Specify a unique idempotency key if you want to perform an idempotent POST or PATCH request. Do not use this header in other request types. With this header specified, the Zuora server can identify subsequent retries of the same request using this value, which prevents the same operation from being performed multiple times by accident. |
Accept-Encoding | string Include the If specified, Zuora automatically compresses responses that contain over 1000 bytes of data, and the response contains a |
Content-Encoding | string Include the |
Authorization | string The value is in the |
Zuora-Entity-Ids | string An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is only valid for a single entity, or you do not have Zuora Multi-entity enabled, you do not need to set this header. |
Zuora-Track-Id | string <= 64 characters A custom identifier for tracing the API call. If you set a value for this header, Zuora returns the same value in the response headers. This header enables you to associate your system process identifiers with Zuora API calls, to assist with troubleshooting in the event of an issue. The value of this field must use the US-ASCII character set and must not include any of the following characters: colon ( |
X-Zuora-WSDL-Version | string Default: 79 Zuora WSDL version number. |
AccountNumber | string Unique account number assigned to the account. Character limit: 50 Values: one of the following:
|
AdditionalEmailAddresses | string List of additional email addresses to receive email notifications. Character limit: 120 Values: comma-separated list of email addresses |
AllowInvoiceEdit | boolean Indicates if associated invoices can be edited.
Character limit: 5 Values: |
AutoPay | boolean Indicates if future payments are automatically collected when they're due during a Payment Run.
Character limit: 5 Values: |
Batch | string Organizes your customer accounts into groups to optimize Note: By default, you have 50 configurable account batches. To increase the limit to 200 batches, you must have the Performance Booster Elite package. |
BcdSettingOption | string Billing cycle day setting option. Character limit: 9 Values: |
BillCycleDay required | integer <int32> Billing cycle day (BCD) on which bill runs generate invoices for the account. Character limit: 2 Values: any activated system-defined bill cycle day ( |
BillToId | string ID of the person to bill for the account. This field is only required if the |
CrmId | string CRM account ID for the account. A CRM is a customer relationship management system, such as Salesforce.com. Character limit: 100 Values: a string of 100 characters or fewer |
Currency required | string Currency that the customer is billed in. |
CustomerServiceRepName | string Name of the account's customer service representative, if applicable. Character limit: 50 Values: a string of 50 characters or fewer |
DefaultPaymentMethodId | string ID of the default payment method for the account. This field is only required if the |
InvoiceDeliveryPrefsEmail | boolean Indicates if the customer wants to receive invoices through email. Character limit: 5 Values: |
InvoiceDeliveryPrefsPrint | boolean Indicates if the customer wants to receive printed invoices, such as through postal mail. Character limit: 5 Values: |
InvoiceTemplateId | string The ID of the invoice template. Each customer account can use a specific invoice template for invoice generation. Character limit: 32 Values: a valid template ID configured in Zuora Billing Settings |
Name required | string Name of the account as displayed in the Zuora UI. Character limit: 255 Values: a string of 255 characters or fewer |
Notes | string Comments about the account. Character limit: 65,535 Values: a string of 65,535 characters |
ParentId | string Identifier of the parent customer account for this Account object. Use this field if you have customer hierarchy enabled. Character limit: 32 Values: a valid account ID |
PartnerAccount | boolean Default: false Whether the customer account is a partner, distributor, or reseller. You can set this field to Note:
|
PaymentGateway | string Gateway used for processing electronic payments and refunds. This field is only required if there is no default payment gateway is defined in the tenant. Character limit: 40 Values: one of the following:
|
PaymentTerm | string Indicates when the customer pays for subscriptions. Character limit: 100 Values: a valid, active payment term defined in the web-based UI administrative settings |
PurchaseOrderNumber | string The number of the purchase order associated with this account. Purchase order information generally comes from customers. Character limit: 100 Values: a string of 100 characters or fewer |
SalesRepName | string The name of the sales representative associated with this account, if applicable. Character limit: 50 Values: a string of 50 characters or fewer |
SoldToId | string ID of the person who bought the subscription associated with the account. This field is only required if the |
Status required | string <= 8 characters Status of the account in the system. |
TaxCompanyCode | string Unique code that identifies a company account in Avalara. Use this field to calculate taxes based on origin and sold-to addresses in Avalara. This feature is in Limited Availability. If you wish to have access to the feature, submit a request at Zuora Global Support. Character limit: 50 Values: a valid company code |
TaxExemptCertificateID | string ID of your customer's tax exemption certificate. Character limit: 32 Values: a string of 32 characters or fewer |
TaxExemptCertificateType | string Type of the tax exemption certificate that your customer holds. Character limit: 32 Values: a string of 32 characters or fewer |
TaxExemptDescription | string Description of the tax exemption certificate that your customer holds. Character limit: 500 Values: a string of 500 characters or fewer |
TaxExemptEffectiveDate | string <date> Date when the the customer's tax exemption starts. Character limit: 29 Version notes: requires Zuora Tax |
TaxExemptExpirationDate | string <date> Date when the customer's tax exemption certificate expires Character limit: 29 Version notes: requires Zuora Tax |
TaxExemptIssuingJurisdiction | string Indicates the jurisdiction in which the customer's tax exemption certificate was issued. Character limit: 32 Values: a string of 32 characters or fewer |
TaxExemptStatus | string Status of the account's tax exemption. This field is only required if you use Zuora Tax. This field is not available if you do not use Zuora Tax. Character limit: 19 Values: one of the following:
|
VATId | string EU Value Added Tax ID. This feature is in Limited Availability. If you wish to have access to the feature, submit a request at Zuora Global Support. Character limit: 25 Values: a valid Value Added Tax ID |
communicationProfileId | string Associates the account with a specified communication profile. Character limit: 32 Values: a valid communication profile ID |
Class__NS | string <= 255 characters Value of the Class field for the corresponding customer account in NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
CustomerType__NS | string Value of the Customer Type field for the corresponding customer account in NetSuite. The Customer Type field is used when the customer account is created in NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
Department__NS | string <= 255 characters Value of the Department field for the corresponding customer account in NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
IntegrationId__NS | string <= 255 characters ID of the corresponding object in NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
IntegrationStatus__NS | string <= 255 characters Status of the account's synchronization with NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
Location__NS | string <= 255 characters Value of the Location field for the corresponding customer account in NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
Subsidiary__NS | string <= 255 characters Value of the Subsidiary field for the corresponding customer account in NetSuite. The Subsidiary field is required if you use NetSuite OneWorld. Only available if you have installed the Zuora Connector for NetSuite. |
SyncDate__NS | string <= 255 characters Date when the account was sychronized with NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
SynctoNetSuite__NS | string Specifies whether the account should be synchronized with NetSuite. Only available if you have installed the Zuora Connector for NetSuite. |
property name* additional property | any Custom fields of the Account object. The name of each custom field has the form |
{- "Name": "Amy Lawrence",
- "Currency": "USD",
- "BillCycleDay": 1,
- "Status": "Draft"
}
{- "Success": true,
- "Id": "2c93808457d787030157e0321fdf4fab"
}