Create image folder

The CreateImageFolder method creates a new folder in which to store images.

The full image folder tree can be obtained using GetImageFodlers and images can be uploaded using UploadImage. Note that multiple folders with the same name can be created, and that on creation image folder names will be stripped of non-standard characters.

Parameters

username	string	This is the username from your API key. It is in the format of an email address and will look similar to apiuser‑908709770324@apiconnector.com	required
password	string	This is the password from your API key.	required
name	string	The name for your new image folder.	required
parentFolderId	integer	This is the identifier of the parent folder in which this new folder should be created. The root folder has the ID of 0 (zero).	required

Return values

This will return the newly updated image folder tree.

id	integer	The identifier for the root image folder.
name	string	The name for the root image folder.
childFolders		An array of APIImageFolder objects, each consisting of id, name and childFolders. If a folder has no children it will return <ChildFolders xsi:nil="true" />.

Error responses

ERROR_IMAGE_PARENTFOLDERDOESNOTEXIST
ERROR_IMAGE_PARENTFOLDERDELETED
ERROR_IMAGE_NAMEINVALID
ERROR_APIUSAGE_EXCEEDED
ERROR_INVALID_LOGIN
ERROR_SYSTEM_SERVICETEMPORARILYUNAVAILABLE
ERROR_UNKNOWN

Request

POST /API.asmx HTTP/1.1
Host: apiconnector.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://apiconnector.com/CreateImageFolder"

Sample response

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CreateImageFolderResponse xmlns="http://apiconnector.com">
      <CreateImageFolderResult>
        <ID>int</ID>
        <Name>string</Name>
        <ChildFolders>
          <APIImageFolder>
            <ID>int</ID>
            <Name>string</Name>
            <ChildFolders xsi:nil="true" />
          </APIImageFolder>
          <APIImageFolder>
            <ID>int</ID>
            <Name>string</Name>
            <ChildFolders xsi:nil="true" />
          </APIImageFolder>
        </ChildFolders>
      </CreateImageFolderResult>
    </CreateImageFolderResponse>
  </soap:Body>

Prebuilt integrations

More about API

Address books

Contacts

Campaigns

Reporting

SMS

Account

Images

Documents

Templates