|
| 1 | +--- |
| 2 | +title: Microsoft SharePoint Connector for Power Automate |
| 3 | +ms.date: 03/13/2020 |
| 4 | +--- |
| 5 | + |
| 6 | +# Microsoft SharePoint Connector for Power Automate |
| 7 | + |
1 | 8 | Microsoft SharePoint Connector in Power Automate supports the following flow triggers and actions.
|
2 | 9 |
|
3 | 10 | ## SharePoint triggers
|
4 | 11 |
|
5 |
| -#### When an item is created |
| 12 | +### When an item is created |
| 13 | + |
6 | 14 | Triggers the flow when an item is created.
|
7 | 15 |
|
8 |
| -#### When an item is created or modified |
9 |
| -Triggers the flow when an item is created, and each time it is modified, in a SharePoint list. |
| 16 | +### When an item is created or modified |
| 17 | + |
| 18 | +Triggers the flow when an item is created, and each time it is modified, in a SharePoint list. |
10 | 19 |
|
11 |
| -#### When an item is deleted |
12 |
| -Triggers the flow when an item is deleted in a list. To get the properties of a deleted item, this trigger must connect to the associated SharePoint site on which it is expected to run using a site collection user account. |
| 20 | +### When an item is deleted |
| 21 | + |
| 22 | +Triggers the flow when an item is deleted in a list. To get the properties of a deleted item, this trigger must connect to the associated SharePoint site on which it is expected to run using a site collection user account. |
| 23 | + |
| 24 | +### For a selected item |
13 | 25 |
|
14 |
| -#### For a selected item |
15 | 26 | Triggers the flow for a selected item in a list.
|
16 | 27 |
|
17 |
| -#### When a file is created (properties only) |
18 |
| -Triggers the flow when a file is created in a document library, and returns only the custom file properties associated with that file. |
| 28 | +### When a file is created (properties only) |
| 29 | + |
| 30 | +Triggers the flow when a file is created in a document library, and returns only the custom file properties associated with that file. |
| 31 | + |
| 32 | +### When a file is created in a folder |
19 | 33 |
|
20 |
| -#### When a file is created in a folder |
21 | 34 | Triggers the flow when a file is created in a SharePoint folder. This trigger does not run if a file is added or updated in a subfolder inside the folder this trigger is operating on. If the flow is required to trigger on subfolders, create different flows for one or more subfolder(s).
|
22 | 35 |
|
23 |
| -#### When a file is created or modified (properties only) |
| 36 | +### When a file is created or modified (properties only) |
| 37 | + |
24 | 38 | Triggers the flow when a file is created, and each time the file properties are modified in a library. Returns only the custom file properties associated with that file.
|
25 | 39 |
|
26 |
| -#### When a file is created or modified in a folder (properties only) |
| 40 | +### When a file is created or modified in a folder (properties only) |
| 41 | + |
27 | 42 | Triggers the flow when a file is created, and each time the file properties are modified in the selected SharePoint folder. The trigger does not activate if a file is added/updated in a subfolder. If the flow is required to trigger on subfolders, create different flows for one or more subfolder(s).
|
28 | 43 |
|
29 |
| -#### When a file is deleted |
30 |
| -Triggers the flow when a file is deleted in a document library. You can optionally specify a folder to watch. When a folder is deleted, the trigger activates only once for the deleted folder, including its subfolders. To get the properties of the deleted file, this trigger must connect to the associated SharePoint site on which the trigger is epxected to run using a site collection user account. |
| 44 | +### When a file is deleted |
| 45 | + |
| 46 | +Triggers the flow when a file is deleted in a document library. You can optionally specify a folder to watch. When a folder is deleted, the trigger activates only once for the deleted folder, including its subfolders. To get the properties of the deleted file, this trigger must connect to the associated SharePoint site on which the trigger is epxected to run using a site collection user account. |
| 47 | + |
| 48 | +### For a selected file |
31 | 49 |
|
32 |
| -#### For a selected file |
33 | 50 | Triggers the flow for a selected file in a document library.
|
34 | 51 |
|
35 |
| -#### When a site has requested to join a hub site |
| 52 | +### When a site has requested to join a hub site |
| 53 | + |
36 | 54 | Triggers a flow upon hub site join approval request.
|
37 | 55 |
|
38 | 56 | ## SharePoint actions
|
39 | 57 |
|
40 |
| -### Add attachment |
| 58 | +### Add attachment |
| 59 | + |
41 | 60 | Adds a new attachment to the specified list item.
|
42 | 61 |
|
43 |
| -### Approve hub site join request |
| 62 | +### Approve hub site join request |
| 63 | + |
44 | 64 | Approves hub site join request. This action returns an approval token to complete the join request using the join hub site action.
|
45 | 65 |
|
46 |
| -### Cancel hub site join request |
| 66 | +### Cancel hub site join request |
| 67 | + |
47 | 68 | Cancels hub join request. If applicable, specify the same Approval Correlation Id as used in the "Set hub site join status to pending" action.
|
48 | 69 |
|
49 |
| -### Check in file |
| 70 | +### Check in file |
| 71 | + |
50 | 72 | Checks in a checked out file in a document library, which makes the version of the document available to others.
|
51 | 73 |
|
52 |
| -### Check out file |
| 74 | +### Check out file |
| 75 | + |
53 | 76 | Checks out a file in a document library to prevent others from editing the document, and your changes from being visible until you check in the document.
|
54 | 77 |
|
55 |
| -### Copy file |
| 78 | +### Copy file |
| 79 | + |
56 | 80 | Copies a file. Works similarly to the "Copy to" command in SharePoint libraries. Returns info about the new file after copying.
|
57 | 81 |
|
58 |
| -### Copy file (deprecated) |
| 82 | +### Copy file (deprecated) |
| 83 | + |
59 | 84 | Copies a file to a SharePoint site.
|
60 | 85 |
|
61 |
| -### Copy folder |
| 86 | +### Copy folder |
| 87 | + |
62 | 88 | Copies a folder. Works similarly to the "Copy to" command in SharePoint libraries. Returns info about the new folder after copying.
|
63 | 89 |
|
64 |
| -### Create file |
| 90 | +### Create file |
| 91 | + |
65 | 92 | Uploads a file to a SharePoint site. Make sure to pick an existing library.
|
66 | 93 |
|
67 |
| -### Create item |
| 94 | +### Create item |
| 95 | + |
68 | 96 | Creates a new item in a SharePoint list.
|
69 | 97 |
|
70 |
| -### Create new folder |
| 98 | +### Create new folder |
| 99 | + |
71 | 100 | Creates a new folder or folder path.
|
72 | 101 |
|
73 |
| -### Create sharing link for a file or folder |
| 102 | +### Create sharing link for a file or folder |
| 103 | + |
74 | 104 | Creates a sharing link for a file or folder.
|
75 | 105 |
|
76 |
| -### Delete attachment |
| 106 | +### Delete attachment |
| 107 | + |
77 | 108 | Deletes the specified attachment.
|
78 | 109 |
|
79 |
| -### Delete file |
| 110 | +### Delete file |
| 111 | + |
80 | 112 | Deletes the file specified by the file identifier.
|
81 | 113 |
|
82 |
| -### Delete item |
| 114 | +### Delete item |
| 115 | + |
83 | 116 | Deletes an item from a SharePoint list.
|
84 | 117 |
|
85 |
| -### Discard checkout |
86 |
| -Discards the checkout, rather than saves the file, if you check out a file and don’t make changes to it, or you make changes that you don’t want to keep. If your organization tracks versions, a new version is created each time you check a file back into the library. By discarding the checkout, you can avoid making new versions when you haven’t made any changes to the file. |
| 118 | +### Discard checkout |
| 119 | + |
| 120 | +Discards the checkout, rather than saves the file, if you check out a file and don't make changes to it, or you make changes that you don't want to keep. If your organization tracks versions, a new version is created each time you check a file back into the library. By discarding the checkout, you can avoid making new versions when you haven't made any changes to the file. |
| 121 | + |
| 122 | +### Extract folder |
87 | 123 |
|
88 |
| -### Extract folder |
89 | 124 | Extracts an archive file into a SharePoint folder (for example, .zip).
|
90 | 125 |
|
91 |
| -### Get all lists and libraries |
| 126 | +### Get all lists and libraries |
| 127 | + |
92 | 128 | Gets all lists and libraries.
|
93 | 129 |
|
94 |
| -### Get attachment content |
| 130 | +### Get attachment content |
| 131 | + |
95 | 132 | Returns file contents using the file identifier. The contents can be copied somewhere else, or be used as an attachment.
|
96 | 133 |
|
97 |
| -### Get attachments |
| 134 | +### Get attachments |
| 135 | + |
98 | 136 | Returns the list of attachments for the specified list item. To get to the contents of the file, add a "Get attachment content" step, and use the "File identifier" property returned by this action.
|
99 | 137 |
|
100 |
| -### Get file content |
| 138 | +### Get file content |
| 139 | + |
101 | 140 | Gets file contents using the file identifier. The contents can be copied somewhere else, or be used as an attachment.
|
102 | 141 |
|
103 |
| -### Get file content using path |
| 142 | +### Get file content using path |
| 143 | + |
104 | 144 | Gets file contents using the file path.
|
105 | 145 |
|
106 |
| -### Get file metadata |
| 146 | +### Get file metadata |
| 147 | + |
107 | 148 | Gets info about the file, such as size, etag, created date, and so on. Uses a file identifier to pick the file. To get to the values stored in the columns in the library, use "Get file properties" action.
|
108 | 149 |
|
109 |
| -### Get file metadata using path |
| 150 | +### Get file metadata using path |
| 151 | + |
110 | 152 | Gets info about the file, such as size, etag, created date, and so on. Uses a file path to pick the file. To get to the values stored in the columns in the library, use "Get file properties" action.
|
111 | 153 |
|
112 |
| -### Get file properties |
| 154 | +### Get file properties |
| 155 | + |
113 | 156 | Gets the properties saved in the columns in the library for the item specified by the item id. To get to the contents of the file, add a "Get file content" step, and use the "File identifier" property returned by this action. When using this with the On-Premises Data Gateway, you may need to manually enter the name of the library to connect to.
|
114 | 157 |
|
115 |
| -### Get files (properties only) |
| 158 | +### Get files (properties only) |
| 159 | + |
116 | 160 | Gets the properties saved in the columns in the library for all folders and files stored in the library. You can also filter down to the items that match a condition. Use "Apply to each" section to work with the output from this action. When using this with the On-Premises Data Gateway, you may need to be manually enter the name of the library to connect to.
|
117 | 161 |
|
118 |
| -### Get folder metadata |
| 162 | +### Get folder metadata |
| 163 | + |
119 | 164 | Gets info about the folder. Uses a file identifier to pick the folder.
|
120 | 165 |
|
121 |
| -### Get folder metadata using path |
| 166 | +### Get folder metadata using path |
| 167 | + |
122 | 168 | Gets info about the folder. Uses a folder path to pick the folder.
|
123 | 169 |
|
124 |
| -### Get item |
| 170 | +### Get item |
| 171 | + |
125 | 172 | Gets a single item by its id from a SharePoint list.
|
126 | 173 |
|
127 |
| -### Get items |
| 174 | +### Get items |
| 175 | + |
128 | 176 | Gets items from a SharePoint list.
|
129 | 177 |
|
130 |
| -### Get list views |
| 178 | +### Get list views |
| 179 | + |
131 | 180 | Gets views from a SharePoint list.
|
132 | 181 |
|
133 |
| -### Get lists |
| 182 | +### Get lists |
| 183 | + |
134 | 184 | Gets SharePoint lists from a site.
|
135 | 185 |
|
136 |
| -### Grant access to an item or a folder |
| 186 | +### Grant access to an item or a folder |
| 187 | + |
137 | 188 | Grants access to an item or a folder in SharePoint to specific people.
|
138 | 189 |
|
139 |
| -### Join hub site |
| 190 | +### Join hub site |
| 191 | + |
140 | 192 | Joins the requested site to the hub site. An Approval Token is required to complete the join successfully if that hub requires approval. If applicable, specify the same Approval Correlation Id as used in the "Set hub site join status to pending" action.
|
141 | 193 |
|
142 |
| -### List folder |
| 194 | +### List folder |
| 195 | + |
143 | 196 | Returns files contained in a SharePoint folder.
|
144 | 197 |
|
145 |
| -### List root folder |
| 198 | +### List root folder |
| 199 | + |
146 | 200 | Returns files in the root SharePoint folder.
|
147 | 201 |
|
148 |
| -### Move file |
| 202 | +### Move file |
| 203 | + |
149 | 204 | Moves a file. Works similarly to the "Move to" command in SharePoint libraries. Returns info about the new file after its move.
|
150 | 205 |
|
151 |
| -### Move folder |
| 206 | +### Move folder |
| 207 | + |
152 | 208 | Moves a folder. Works similarly to the "Move to" command in SharePoint libraries. Returns info about the new folder after its move.
|
153 | 209 |
|
154 |
| -### Resolve person |
| 210 | +### Resolve person |
| 211 | + |
155 | 212 | Returns a single matching user value so it can be assigned to a column of type person. If there are no matches, or multiple matches, this action errors out.
|
156 | 213 |
|
157 |
| -### Send an HTTP request to SharePoint |
| 214 | +### Send an HTTP request to SharePoint |
| 215 | + |
158 | 216 | Constructs a SharePoint REST API to invoke. Note: This action may execute any SharePoint REST API you have access to. Proceed with caution.
|
159 | 217 |
|
160 |
| -### Set content approval status |
| 218 | +### Set content approval status |
| 219 | + |
161 | 220 | Sets the content approval status for an item in a list or library that has content approval turned on. You must provide an ETag for pages and files. You can get the ETag using the Get File Metadata action. This action is only available for SharePoint Online and SharePoint 2019.
|
162 | 221 |
|
163 |
| -### Set hub site join status to pending |
| 222 | +### Set hub site join status to pending |
| 223 | + |
164 | 224 | Sets the requested site's hub join request status to pending. The Approval Correlation Id is an optional parameter that helps SharePoint identify a particular hub join request. The requesting site can only have one pending request at a given time.
|
165 | 225 |
|
166 |
| -### Stop sharing an item or a file |
| 226 | +### Stop sharing an item or a file |
| 227 | + |
167 | 228 | Deletes all links giving access to an item or a file, and removes all people with direct access, except for owners.
|
168 | 229 |
|
169 |
| -### Update file |
| 230 | +### Update file |
| 231 | + |
170 | 232 | Updates the contents of the file specified by the file identifier.
|
171 | 233 |
|
172 |
| -### Update file properties |
| 234 | +### Update file properties |
| 235 | + |
173 | 236 | Updates the properties stored in columns in a library for the item specified by the item id. To update file contents, use the "Update file" action. When using this with the On-Premises Data Gateway, you may need to manually enter the name of the library to connect to.
|
174 | 237 |
|
175 |
| -### Update item |
| 238 | +### Update item |
| 239 | + |
176 | 240 | Updates an item in a SharePoint list.
|
0 commit comments