Folders
Create, update, delete, and query Folders for a Marketo organization.
Select
Note: Filters provided with one of the supported operators listed in the "Operators" column are processed server-side, all the other filters are processed client-side.
For example, the following queries are processed server-side:
SELECT * FROM Folders WHERE Name='Marketo8'
SELECT * FROM Folders WHERE Name='Default'
SELECT * FROM Folders WHERE Name='Default' AND WorkspaceName='Default'
SELECT * FROM Folders WHERE MaxDepth=1;
SELECT * FROM Folders WHERE ParentId=12 AND ParentType='Folder'
SELECT * FROM Folders WHERE ParentId=12
Insert
INSERT INTO Folders (Name, ParentId, ParentType, Description) VALUES ('newFolder1234567', 38, 'Folder', 'test insert description')
Update
Note: Folders of Type='Program' can not be updated. UPDATE Folders SET Description='test update folders2', IsArchive='true' WHERE Id IN (5910, 5911) AND Type='Folder'
Delete
Note: Folders of Type='Program' and folders with IsSystem=true can not be deleted.
DELETE FROM Folders WHERE Id=5363 AND Type='Folder'
Columns
Name | Type | ReadOnly | Operators | Description |
Id [KEY] | Int | True | = |
The unique, Marketo-assigned identifier of the folder. |
Type [KEY] | String | False | = |
The type of the folder (Folder or Program). |
Name | String | False | = |
The name of the folder. |
Description | String | False |
The description of the folder. | |
FolderType | String | True |
The type of the folder (Revenue Cycle Model, Marketing Folder, List, Smart List). | |
ParentId | Int | False | = |
The Id of the parent folder. |
ParentType | String | False | = |
The type of the parent folder. |
Path | String | True |
The path of a folder shows its hierarchy in the folder tree, similar to a Unix-style path. | |
WorkspaceName | String | True | = |
The name of the smart campaign workspace. |
URL | String | True |
The explicit URL of the asset in the designated instance. | |
IsSystem | Bool | True |
Whether or not the folder is a system folder. | |
IsArchive | Bool | False |
Whether or not the folder is archived. | |
AccessZoneId | Int | True |
The access zone id | |
CreatedAt | Datetime | True |
The date and time the folder was created. | |
UpdatedAt | Datetime | True |
The date and time the folder was last updated. | |
MaxDepth | Int | True | = |
Mirror column used to specify the maximum folder depth to traverse. Will be ignored when filtering by Id or Name. |