{"id":31376,"date":"2018-04-21T15:47:45","date_gmt":"2018-04-21T15:47:45","guid":{"rendered":"https:\/\/ampscript.guide\/functions-invokecreate\/"},"modified":"2021-04-06T01:18:20","modified_gmt":"2021-04-06T01:18:20","slug":"invokecreate","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/invokecreate\/","title":{"rendered":"InvokeCreate"},"content":{"rendered":"

InvokeCreate<\/h2>\n

This function executes the creation of the instantiated Marketing Cloud API Object<\/a>. The function returns a status code, message and an error code.<\/p>\n

API error codes are outlined in the official documentation<\/a>.<\/p>\n

Arguments<\/h3>\n

InvokeCreate(1,2,3,4)<\/code><\/p>\n\n\n\n\n\n\n\n\n
Ordinal<\/th>\nType<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nAPI Object<\/td>\nTrue<\/td>\nThe API Object to be created<\/td>\n<\/tr>\n
2<\/td>\nVariable<\/td>\nTrue<\/td>\nThe AMPscript variable in which the resulting status message is stored<\/td>\n<\/tr>\n
3<\/td>\nVariable<\/td>\nTrue<\/td>\nThe AMPscript variable in which the resulting error code is stored<\/td>\n<\/tr>\n
4<\/td>\nAPI Object<\/td>\nFalse<\/td>\nThe optional CreateOptions API Object<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Example<\/h3>\n

The following example creates a new DataFolder<\/code> object in the specified parent folder. The attributes of the object are specified with the SetObjectProperty()<\/code> function.<\/p>\n

%%[\n\nvar @df, @parentFolder, @createStatusCode, @createStatusMessage, @createErrorCode\nset @df = CreateObject(\"DataFolder\")\nSetObjectProperty(@df, \"Name\", \"Test Folder\")\nSetObjectProperty(@df, \"Description\", \"Test Folder Description\")\nSetObjectProperty(@df, \"CustomerKey\", \"Test Folder\")\nSetObjectProperty(@df, \"ContentType\", \"email\")\nSetObjectProperty(@df, \"IsActive\", \"true\")\nSetObjectProperty(@df, \"IsEditable\", \"true\")\nSetObjectProperty(@df, \"AllowChildren\", \"true\")\n\nset @parentFolder = CreateObject(\"DataFolder\")\nSetObjectProperty(@parentFolder, \"ID\", \"13738\") \/* CategoryID of \"my emails\" folder *\/\n\nSetObjectProperty(@df, \"ParentFolder\", @parentFolder)\n\nset @createStatusCode = InvokeCreate(@df, @createStatusMessage, @createErrorCode)\n\n]%%\ncreateStatusCode: %%=v(@createStatusCode)=%%\n<br>createStatusMessage: %%=v(@createStatusMessage)=%%\n<br>createErrorCode: %%=v(@createErrorCode)=%%<\/code><\/pre>\n
Output<\/h4>\n
createStatusCode: OK\ncreateStatusMessage: Folder created successfully.\ncreateErrorCode: 0<\/code><\/pre>\n
If the DataFolder<\/code> already exists, it will return an error:<\/p>\n
createStatusCode: Error\ncreateStatusMessage: ParentFolder ID: \"13738\" already has a child Folder named \"Test Folder\". Please select a different Name.\ncreateErrorCode: 396007<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
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 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"yoast_head":"\nThe AMPscript Guide - InvokeCreate<\/title>\n<meta name=\"robots\" content=\"index, follow\" \/>\n<meta name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta name=\"bingbot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ampscript.guide\/invokecreate\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The AMPscript Guide - InvokeCreate\" \/>\n<meta property=\"og:description\" content=\"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 […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ampscript.guide\/invokecreate\/\" \/>\n<meta property=\"og:site_name\" content=\"The AMPscript Guide\" \/>\n<meta property=\"article:published_time\" content=\"2018-04-21T15:47:45+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-04-06T01:18:20+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ampscript.guide\/#website\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"The AMPscript Guide\",\"description\":\"The Definitive Scripting Manual for Salesforce Marketing Cloud\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/ampscript.guide\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/invokecreate\/#webpage\",\"url\":\"https:\/\/ampscript.guide\/invokecreate\/\",\"name\":\"The AMPscript Guide - InvokeCreate\",\"isPartOf\":{\"@id\":\"https:\/\/ampscript.guide\/#website\"},\"datePublished\":\"2018-04-21T15:47:45+00:00\",\"dateModified\":\"2021-04-06T01:18:20+00:00\",\"author\":{\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\"},\"breadcrumb\":{\"@id\":\"https:\/\/ampscript.guide\/invokecreate\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ampscript.guide\/invokecreate\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ampscript.guide\/invokecreate\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/invokecreate\/\",\"url\":\"https:\/\/ampscript.guide\/invokecreate\/\",\"name\":\"InvokeCreate\"}}]},{\"@type\":[\"Person\"],\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\",\"name\":\"dev\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","_links":{"self":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31376"}],"collection":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/comments?post=31376"}],"version-history":[{"count":0,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31376\/revisions"}],"wp:attachment":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/media?parent=31376"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/categories?post=31376"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/tags?post=31376"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}