InvokeCreate
This function executes the creation of the instantiated Marketing Cloud API Object. The function returns a status code, message and an error code.
API error codes are outlined in the official documentation.
Arguments
InvokeCreate(1,2,3,4)
| Ordinal | Type | Required | Description |
|---|---|---|---|
| 1 | API Object | True | The API Object to be created |
| 2 | Variable | True | The AMPscript variable in which the resulting status message is stored |
| 3 | Variable | True | The AMPscript variable in which the resulting error code is stored |
| 4 | API Object | False | The optional CreateOptions API Object |
Example
The following example creates a new DataFolder object in the specified parent folder. The attributes of the object are specified with the SetObjectProperty() function.
%%[
var @df, @parentFolder, @createStatusCode, @createStatusMessage, @createErrorCode
set @df = CreateObject("DataFolder")
SetObjectProperty(@df, "Name", "Test Folder")
SetObjectProperty(@df, "Description", "Test Folder Description")
SetObjectProperty(@df, "CustomerKey", "Test Folder")
SetObjectProperty(@df, "ContentType", "email")
SetObjectProperty(@df, "IsActive", "true")
SetObjectProperty(@df, "IsEditable", "true")
SetObjectProperty(@df, "AllowChildren", "true")
set @parentFolder = CreateObject("DataFolder")
SetObjectProperty(@parentFolder, "ID", "13738") /* CategoryID of "my emails" folder */
SetObjectProperty(@df, "ParentFolder", @parentFolder)
set @createStatusCode = InvokeCreate(@df, @createStatusMessage, @createErrorCode)
]%%
createStatusCode: %%=v(@createStatusCode)=%%
<br>createStatusMessage: %%=v(@createStatusMessage)=%%
<br>createErrorCode: %%=v(@createErrorCode)=%%Output
createStatusCode: OK
createStatusMessage: Folder created successfully.
createErrorCode: 0If the DataFolder already exists, it will return an error:
createStatusCode: Error
createStatusMessage: ParentFolder ID: "13738" already has a child Folder named "Test Folder". Please select a different Name.
createErrorCode: 396007