Create a Folder

Use the Post method to create a new folder within a Marketing Cloud account.

Ruby

require 'fuelsdk'
myClient = FuelSDK::Client.new {'client' => { 'id' => CLIENTID, 'secret' => SECRET }}
folder = FuelSDK::Folder.new 
folder.authStub = myclient
folder.props = {"CustomerKey" => "SDKExampleFolder", "Name" => "SDKExampleFolder", "Description" => "SDKExampleFolder", "ContentType"=> "EMAIL", "ParentFolder" => {"ID" => "1515"}, "AllowChildren" => "true", "IsEditable" => "true"}        
results = folder.post
p results

PHP

require('ET_Client.php');
$myclient = new ET_Client();
$folder = new ET_Folder();
$folder->authStub = $myclient;
$folder->props = array("CustomerKey" => "SDKExampleFolder", "Name" => "SDKExampleFolder", "Description" => "SDKExampleFolder", "ContentType"=> "EMAIL", "ParentFolder" => array("ID" => "1515"), "AllowChildren" => "true", "IsEditable" => "true");
$results = $folder->post();
print_r($results);

Python

import ET_Client
myclient = ET_Client.ET_Client()
folder = ET_Client.ET_Folder()
folder.auth_stub = myclient
folder.props = {"CustomerKey" : "SDKExampleFolder", "Name" : "SDKExampleFolder", "Description" : "SDKExampleFolder", "ContentType": "EMAIL", "ParentFolder" : {"ID" : "1515"}, "AllowChildren" : "true", "IsEditable" : "true" }
results = folder.post()
print results

CSharp

Using FuelSDK;
ET_Client myclient = new ET_Client()
ET_Folder folder = new ET_Folder();
folder.AuthStub = myclient;
folder.Name = "SDKExampleFolder";
folder.Description = "SDKExampleFolder";
folder.CustomerKey = "SDKExampleFolder";
folder.ParentFolder = new ET_Folder();
folder.ParentFolder.ID = 1515;
folder.ContentType = "EMAIL";
folder.IsEditable = true;
folder.AllowChildren = true;
PostReturn results = folder.Post();
Console.WriteLine("Post Status: " + results.Status.ToString());

Java

Properties

You can provide the following values for the props property on the object:

  • Name
    • String datatype
    • Name of the object
  • Description
    • String datatype
    • Describes and provides information regarding the object
  • ContentType
    • String datatype
    • Defines the type of content contained within a folder
    • Valid Values:
      • automated_email
      • campaign
      • condensedlpview
      • content
      • dataextension
      • document
      • email
      • filteractivity
      • filterdefinition
      • globalemail
      • globalemailsub
      • group
      • image
      • job
      • list
      • livecontent
      • measure
      • media
      • microsite
      • micrositelayout
      • mysubs
      • organization
      • programs2
      • publication
      • queryactivity
      • shared_content
      • shared_data
      • shared_dataextension
      • shared_email
      • shared_item
      • shared_portfolio
      • shared_publication
      • shared_suppression_list
      • shared_survey
      • shared_template
      • suppression_list
      • survey
      • template
      • triggered_send
      • userinitiatedsends
  • IsEditable
    • Boolean datatype
    • Indicates if the property can be edited by the end-user in the UI
  • AllowChildren
    • Boolean datatype
    • Specifies whether a data folder can have child data folders
  • ParentFolder
    • ID
      • Int32 datatype
      • System-controlled numeric unique identifier for the parent folder
    • CustomerKey
      • String datatype
      • User-supplied unique identifier for the parent folder