---
schema_version: "1"
id: 69deac5e747f296a77b9a6b15229ac7c9507e83315c9ac1bb378ad59ba06fa86
title: Create
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/create_appex.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/create_appex.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: a996042d322c670d72d2364bb8ecbf996212043f601629f23576290fa72797b8
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Create

Creates an individual object or a batch of objects.

## Parameters

| Name            | Data Type                                  | Description                                  |
| --------------- | ------------------------------------------ | -------------------------------------------- |
| `Objects`       | Array of [APIObject](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/apiobject.md) objects | A collection of objects.                     |
| `Options`       | [UpdateOptions](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/updateoptions.md) object   | Optionally specifies processing options.     |
| `OverallStatus` | String                                     | Specifies the overall status of the request. |
| `RequestID`     | String                                     | A unique identifier for the request.         |

## Description

The Create method allows objects to be created-individually or in batches. Multiple object types can be created with one call. Objects are created when they are added to the APIObject array.

## Input

- `CreateOptions` - A CreateOptions instance is required for this parameter, but you don't need to define properties for the instance.

- `APIObjects` - An array of objects to be acted upon. The objects are acted on in the order they have been added - first in, first out. This array can hold different object types. Therefore, complex interactions like creating an email, creating a list, and sending the email can be accomplished in one call.

- `RequestID` - This parameter contains a string value containing an output variable of the key of the request. By default, this value is a GUID (Globally Unique Identifier).

- `OverallStatus` - This parameter returns a string value containing the overall status of the request. Valid status values include:

  - `OK` - This status code states that all objects were successfully created.
  - `Has Error` -Valid for Create method calls with multiple APIObject objects, this status code states that some of the operations failed, while some succeeded.
  - `Error` - This status code states that all create operations failed during validation or processing.

## Output

- `CreateResult` - An array of objects holding a list of return values. The objects are returned in the order acted upon: first in, first out. This array contains one CreateResult object per input APIObject.

## RelatedItems

- [CreateResult](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/createresult_appex.md)