InvokeRetrieve()

Invokes the Retrieve method on a Marketing Cloud Engagement API Object and returns the API status message and request ID.

The InvokeRetrieve() function has three parameters:

  • apiObject (API Object): Required. The API Object to invoke the Retrieve method on.
  • statusMessage (AMPscript variable): An AMPscript variable that stores the API status message.
  • requestId (AMPscript variable): An AMPscript variable that stores the request ID.

This example creates a RetrieveRequest Object, sets a property, and adds an array item. It then creates a simple filter that finds matching email addresses. Finally, the function calls the InvokeRetrieve() function, outputting the status message and the request ID.