日本語のコンテンツは機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は保証できません。英語版が正となります。また、現時点では検索機能は日本語での検索をサポートしていません。翻訳に関するフィードバックについては、docs@zuora.comに送信してください。

US Data Center Customers: The SOAP API is no longer under active development. The legacy SOAP calls still function, but are now also available in REST.
EU Data Center Customers: The SOAP API is not available. Please use the REST API.
APAC Data Center Customers: The SOAP API is not available. Please use the REST API.
Going forward, new features will only be available through the REST API. We strongly recommend that all integrations are done using the REST API.
You can find the REST API documentation at https://www.zuora.com/developer/.

create()

Last updated

Jan 8, 2020
Save as PDF

Use the create() call to create one or more objects of a specific type. You can specify different types in different create() calls, but each create() call must apply to only one type of object. This SOAP API reference includes syntax, call wrappers and container descriptions, requirements, and examples.

Usage

Objects per Call Limits

50 objects are supported in a single call.

Syntax and Arguments

SaveResult[] = create(zObject[])

The call takes the following arguments.

Argument	Description
zObject[]	An array of one or more objects of type zObject.

How to Use this Call

You can call create() on an array of one or more zObjects. It returns an array of SaveResults, indicating the success or failure of creating each object. The following information applies to this call:

You cannot pass in null zObjects.
You can pass in a maximum of 50 zObjects at a time.
All objects must be of the same type.
SaveResult should be in the Response section of create().

Using create() and subscribe()

Both the create() and subscribe() calls will create a new account. However, there are differences between the calls.

Use the create() call to create an account independent of a subscription.

Use the subscribe() to create the account with the subscription and the initial payment information.

See subscribe() for more information.

Using create() and CallOptions

The CallOptions complex type is used when using the create() call with an amendment. It is only used in versions 25.0+ of the API, and is used when creating amendments in a single call. This insures that if one of the operations fails (either create or activate), the entire action will be rolled back.

Zuora recommends using the amend() call to create amendments.

See the CallOptions complex type for more information.

Response

SaveResult

Faults

Sample Code

01// create account
02Account acc = new Account();
03acc.setName("Test Account");
04acc.setBatch("Batch1");
05acc.setBillCycleDay(1);
06acc.setAllowInvoiceEdit(true);
07acc.setCurrency("USD");
08acc.setStatus("Draft"); 
09  
10ZObject[] objs = new ZObject[1];
11objs[0] = acc; 
12  
13Create create = new Create();
14create.setZObjects(objs); 
15  
16CreateResponse resp = stub.create(create, this.header);
17SaveResult[] res = resp.getResult();
18ID accountId = res[0].getId();