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)
]%%