Knowledge Center

Knowledge Center > API > SOAP API > SOAP API Calls > create()

create()

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

Sample Code

// create account
Account acc = new Account();
acc.setName("Test Account");
acc.setBatch("Batch1");
acc.setBillCycleDay(1);
acc.setAllowInvoiceEdit(true);
acc.setCurrency("USD");
acc.setStatus("Draft"); 
 
ZObject[] objs = new ZObject[1];
objs[0] = acc; 
 
Create create = new Create();
create.setZObjects(objs); 
 
CreateResponse resp = stub.create(create, this.header);
SaveResult[] res = resp.getResult();
ID accountId = res[0].getId();
Last modified
15:59, 2 Mar 2017

Tags

Classifications

(not set)