Office 365: Create Folder
Description
This step creates a new mail folder in a Microsoft 365 mailbox. You provide the folder name and optionally the parent folder. Use this step in workflows that set up folder structures for email organization, create archive folders, or prepare mailboxes for automated email sorting. Notes:
- The step may not work for the folder having special characters in the folder name.
- In the folder name forward slash
(/)and backward slash(\)is not allowed.
Permission:
-
Following permissions are required to create an event in Office 365:
Permission type Permission (from least to most privileged) Delegated Mail.ReadWrite Delegated offline_access -
To access a shared mailbox, verify the following configurations are complete:
- Provide admin consent for the corresponding delegated *.Shared Microsoft Graph permissions
Mailbox permission on the shared mailbox Delegated Graph permission (app registration) Full Access Mail.ReadWrite.Shared
- Provide admin consent for the corresponding delegated *.Shared Microsoft Graph permissions
Configurations
| No. | Field Name | Description |
|---|---|---|
| 1 | Step Name | Name of the step. This name has to be unique in a single workflow. |
| Connection: | For details about app registration, see Office 365 App Registration for Grant Type – Password Grant or Office 365 App Registration for Grant Type Refresh Token | |
| 2 | Grant Type | Select the type of grant from Password Grant or Refresh Token. The data type is string. This field is mandatory. Note: It is recommended to select the grant type from Refresh Token. |
| 3 | Tenant ID | Tenant ID of Microsoft Account. The data type is string. This field is mandatory. |
| 4 | Client ID | Client ID of the Application created in Microsoft Account. The data type is string. This field is mandatory. |
| Client Secret: | ||
| 5 | Accept Value as variable/static | Leave checkbox unchecked to accept Client Secret value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Client Secret field to appear as Text box. |
| 6 | Client Secret | Specify the Client Secret generated in Microsoft Account. Client Secret is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). If checkbox above is enabled Client Secret field appears as a Text box and accepts static or variable values. Else if checkbox above is disabled Client Secret field appears as a drop down to select fields from previous steps. The data type is secure string. This field is mandatory. |
| 7 | Username | Specify the name of the user whose email attachments are to be downloaded. |
| 8 | Password | Specify the password for the provided user name. |
| 9 | Refresh Token | Specify the refresh token required to authenticate the details. Note: For MFA-enabled user account, select Grant Type as Refresh Token. |
| 10 | Button: Test Connection | Test connection with Client ID and Client Secret provided. Verifies whether the connection is established or not. Note: For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed. |
| Input Fields: | ||
| 1 | Shared Mailbox Email | Specify the email address of a shared mailbox to create the new folder inside the associated folder tree. Leave the field blank to create the folder for the currently authenticated account instead. Note: The authenticated account must have access permissions for the shared mailbox, else the step fails and returns a Microsoft Graph permission error. The field accepts static values and environment variables |
| 2 | Folder Path | Provide folder name or folder path to create the folder. Note: Provide the folder path separated by slash (/). |