How to start flow from List or Library control and pass selected items

List or Library control allows selection of multiple items, which can then be manipulated in a variety of ways.

Multiple items can be selected

In this article we’ll show you how you can add a new button to List or Library control which will start a new Flow, and use selected items to create a PDF invoice.

Form configuration

First, create form a with List or Library control. We’ll use Order form with Order items in List or Library:

List or Library export

We’ll use JavaScript to add a new button:

//this URL needs to be updated
var url = 'FLOW_URL';

fd.spRendered(function() {
    //new button
    var pdfButton = {
        text: 'Email PDF invoice',
        class: 'btn-secondary',
        visible: false,
        icon: 'PDF',
        iconType: 0,
        click: function() {
            //get item IDs of selected items
            var itemIds = fd.control('ListOrLibrary1'){ return parseInt(item.ID)} );

            //send a request to start flow
            fetch(url, {
                method: 'POST',
                body: JSON.stringify({ids: itemIds}),
                'Content-Type': 'application/json'
            .then(function(response) {
                if (response.status !== 202) {
                alert('Looks like there was a problem. Status Code: ' + response.status);
                } else {
                alert('Please, check your e-mail.');

    fd.control('ListOrLibrary1').ready(function(dt) {
        //dt parameter is the same as fd.control('ListOrLibrary1')

        dt.$watch('selectedItems', function(items) {
            pdfButton.visible = items && items.length > 0 ;


This JavaScript code will allow button to show up only when some items are selected. This button would send a POST request to MS Flow with the IDs of currently selected items.


Create a new Flow from blank, and search for Request connector - When a HTTP request is received:

Search for Request connector

Give it the following Request Body JSON schema:

   "type": "object",
   "properties": {
      "ids": {
         "type": "array",
         "items": {
            "type": "integer"

Next search for Variables connector - Initialize variable:

Search for Initialize variable

We’ll need to Initialize an Array variable to hold SharePoint Items.

To populate the array, we search for SharePoint connector - Get Item action (not Get Items!):

Search for SharePoint Get Item

You then need to fill out the information about List or Library Source List, and select Item as Item ID:

Dynamic content ID

This will automatically transform SharePoint Get Item action into a part of Apply to Each actions, which will be applied to all Item IDs sent in a request.

This can be used with Compose action to define certain variables. Search for Compose action and add it inside Apply to Each loop, you can define current SharePoint item variables, such as Amount, Price, Total, etc.

Compose and append to array

After getting all the items to the Array, it’s now possible to use them in our own actions. In this example, we’re using two actions from Plumsail Documents.

We’ll use Create HTML from Template:

Create HTML from Template

And then Convert HTML to PDF:

Convert HTML to PDF

The result of which we’ll send as an attachment in an email with Send an email action:

Send an email

All we need to do now is save the Flow, and copy the URL from When a HTTP request is received action:

Copy URL

Back to our JavaScript editor:

JavaScript editor with new URL


So, this is how the button looks like on the form, when items are selected:

New button on the form

And here’s a preview of the PDF received in an email:

Result PDF