Use the Create method to create an individual object or batch of objects. You can create multiple objects with one call.

Don't use existing objects with the Create method. Adding existing objects to the Create method causes an error.

NameData TypeDescription
ObjectsAPIObject[]A collection of one or more objects to create. The objects are created in the order they have been acted upon--first in, first out. This array can hold different object types, which allows you to perform complex interactions like creating an email, creating a list, and sending the email, in one call.
OptionsCreateOptionsOptionally specifies more processing options. A CreateOptions instance is required for this parameter. However, no properties need to be defined for the instance.
RequestIDStringA unique identifier for the request. This parameter contains a string value containing an output variable of the key of the request. By default, this value is a GUID.
NameData TypeDescription
CreateResultArrayAn array of objects holding a list of return values. The objects are returned in the order they are created: first in, first out. This array contains one CreateResult object per input APIObject.
OverallStatusStringA string value containing the overall status of the request. Possible values are OK (all objects were successfully created), Has Error (some of the operations failed) and Error (all create operations failed).