SharePoint Online - Create a folder

Use the SharePoint Online - Create a folder action A tool for building the processes, logic, and direction within workflows. to create a folder in a SharePoint Online list.

For more information about the SharePoint Online connector, go to SharePoint Online.

Before you begin: 

Jump to:

Configure the SharePoint Online - Create a folder action

Prerequisites 

Folder creation must be enabled for the SharePoint Online list you select for the Create a folder action to run successfully. To enable folder creation set the Make "New Folder" command available option to Yes for the selected SharePoint Online list. For more information, see the Turn folders on in SharePoint section in this help page.

Important: Before inserting variables in the action configuration, you must manually type or select the values and populate other dependent fields in order to retrieve the output data. Once configured, you can insert variables to the required fields.

  1. Open the action configuration panel. For more information, see Add, rename, and copy actions.

  2. Select a Connection. If you do not have a connection, see Add a connection.

    Note: 

    Only the connections created with the List and libraries authentication method are available in the drop-down list.

    For more information about authentication methods for SharePoint Online connections, see Authentication methods for SharePoint Online connections.

  1. In List name, select the list or library where you want to create the folder.
  2. Type a Folder name or insert a variable.

SharePoint Online - Create a folder action fields and settings

Important: Before inserting variables in the action configuration, you must manually type or select the values and populate other dependent fields in order to retrieve the output data. Once configured, you can insert variables to the required fields.

Section Field Description Variable types
(unlabeled)

Connection Credentials and other settings required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.

SharePoint Online connection to connect to the SharePoint Online site that contains the list in which you want to create the folder.

To refresh the available connections, click Refresh.

 (n/a)
New folder

SharePoint site URL

The URL of the SharePoint Online site that has the list or document library you want to use.

To retrieve the lists for the SharePoint site URL, type the SharePoint site URL and click Retrieve lists.

Example: https://domain.sharepoint.com/sites/hr

Boolean, Collection, DateTime, Decimal, Integer, Text
 

List name

The list in which you want to create a folder.

The lists and document libraries within the site specified in SharePoint site URL are displayed in the drop-down list.

Folder creation must be enabled for the SharePoint Online list you select for the action to run successfully. To enable folder creation set the Make "New Folder" command available option to Yes for the selected SharePoint Online list. For more information, see the Turn folders on in SharePoint section in this help page.

When List name is selected the Add fields button will be displayed to add fields and values for the folder you are creating.

Boolean, Collection, DateTime, Decimal, Integer, Text
  Folder name The name for the new folder you are creating. Boolean, Collection, DateTime, Decimal, Integer, Text
  Folder path

The folder path to create the folder in.

Example: /documents/drafts

Note:  If the folder does not exist in the specified path, a new folder is created.

 Boolean, Collection, DateTime, Decimal, Integer, Text
  Add fields

(Is displayed only when a List name is selected.) Displays selections to select and add columns (fields) that you want to add to the folder. Add the fields and specify the values for the added fields.

  1. Click Add fields to view fields for the selected list.
  2. Select each field you want and then click Add.

  3. For each added field, specify the value you want.

See Valid values for added fields, by column type

The values you enter must meet SharePoint Online formatting requirements for the related column type. See, Valid values for added fields, by column type.

Selection

Description

Filter options ()

Type in text to filter the list of fields.

Select all

Selects all fields.

Cancel

Discards field selections and hides the fields available for selection.

Add

Adds the selected fields.

(n/a)
Output

Result

Store the result of the action in an object with the following variables:

  • Folder ID: Integer variable to store the ID of the created folder.
  • Folder URL: Text variable to store the URL of the created folder.

Object

The values you enter for the added fields must meet the following formatting requirements:

Column type (SharePoint Online) Value entry guidance (Nintex Automation Cloud)

Choice

<choice 1>

Example: Blue

Supported variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in the workflow, such as an email address. types: Text

Note: Multiple-selection columns cannot be updated using the action Update an item. That is, Choice type SharePoint columns configured with the "Checkboxes (allow multiple selections)" option for "Display choices using" setting, cannot be updated.

Single value only. New columns are configured with the "Display choices using" option of "Drop-down Menu."

Currency

<decimal value>

Example: 25.50

Supported variable types: Decimal

Date and Time

<date or date/time>

Example: 20170602

Supported variable types: DateTime

For updates to date-only columns, removes time.
Hyperlink or Picture

<URL>,<description>

Example: https://www.nintex.com,Nintex

Supported variable types: Text

Lookup

<ID of list item in selected list>

Example: 1

Supported variable types: Integer
Managed Metadata

<unique identifier of the term in the term store>

Example: 883f304208f84f78bbe6d48d7e34c494

Supported variable types: Text

Multiple lines of text

<text and/or HTML>

Example: <b>ACME</b> invoice

OR

ACME invoice

(HTML is supported when "Enhanced rich text" is enabled for the SharePoint column.)

Supported variable types: Text

Number

<integer>

Example: 1

Supported variable types: Integer

Person or Group

<person or group ID>; <person or group ID>

Example: 1;2

Supported variable types: Integer

Single line of text

<text>

Example: ACME Invoice

Supported variable types: Text

Task Outcome

<choice 1>

Example: Approved

Supported variable types: Text

Single value only. Typically used to update task lists.

Yes/No

<true/false>

Example: True

Supported variable types: Boolean

For more information about column types, see List and library column types (Microsoft article).