# AddObjectArrayItem()

Adds an object to an array in a Marketing Cloud Engagement API object.

## Availability

<table>
  <tr>
    <td>Marketing Cloud Engagement</td>
    <td>✅ Yes</td>
  </tr>
  <tr>
    <td>Marketing Cloud Next</td>
    <td>❌ No</td>
  </tr>
</table>

## Syntax

```
AddObjectArrayItem(apiObject,
                   arrayProperty,
                   itemToAdd)
```

The `AddObjectArrayItem()` function has three parameters:

- `apiObject` (API Object): Required. The API object that contains the array that you want to modify.
- `arrayProperty` (string): Required. The array property to receive the new item.
- `itemToAdd` (string): Required. The item to add to the array.

## Usage

This example adds the attribute `myNewAttribute` to the `Attributes` array on the `mySubscriber` API object.

```
%%[
  AddObjectArrayItem(@mySubscriber,'Attribute',@myNewAttribute)
]%%
```