An input document contains the metadata of the permission to be created.
An output document contains the created (or shared) permissions on the item with the recipients.
Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.
SharePoint Online - Create Permission
Required. The name of a site that contains the list of document library to be used in the subsequent Snap settings.
Custom Site Path
Enable this option if your site URL contains a custom path that deviates from the default site URL. Default site path always has a prefix ‘sites/’ before the sitename, a custom site can contain the prefix ‘teams/’ or it can have no prefix.
Required. This property enables you to select a drive representing the top-level container for a file system, such as OneDrive or SharePoint document libraries. This field populates dynamically from different sites via the suggestion drop-down list. You can select a document library from the suggestion drop-down list or manually type an entity.
If you enable theSiteproperty as expression, then the document libraryis not suggested, resulting in an exception.
Source item relative path
Required. The item resource path that represents a file, folder, or other item stored in a document library on which we want to create the permission.
Required.Specify the roles that are to be granted to the recipients of the invitation.
Required. Comma-separated recipients who will receive access and the sharing invitation to the selected item.
Optional. A plain text formatted message that is included in the sharing invitation. Maximum length of 2000 characters.
Optional. Enable this property to send the invitation to sign-in to view the shared item with the recipients.
Optional. Enable to send a sharing link to the recipient. Otherwise, a permission is granted directly without sending a notification.
Settings to influence connection properties to the SharePoint Online APIs.
This fieldset comprises the following fields:
Retry interval (seconds)
Required. Set the connection timeout duration in seconds.
Number of retries
Required. Set the maximum number of reconnections in case of a connection failure or timeout.
Retry interval (seconds)
Required. Set the time interval in seconds between connection attempts.
Specifytherequired Pipelineexecution type:
Validate & Execute. Performs limited execution of the Snap (up to 50 records) during Pipeline validation; performs full execution of the Snap (unlimited records) during Pipeline execution.
Execute only. Performs full execution of the Snap during Pipeline execution; does not execute the Snap during Pipeline validation.
Disabled. Disables the Snap and, by extension, its downstream Snaps.
Validate & Execute
For more information on how to update an item permissions in the SharePoint Online, refer to the graph API, see Change Sharing-Permissions.
HTTP Response Code:404
Entered item not found in the document library
Please ensure to provide the valid item path to get the metadata.
Either user or app don't have sufficient permissions to read the metadata for the document library.
Ensure to provide the desired permissions both at the user and application level.
Creating Permission for an Item
This example demonstrates how you can create a permission on a specified item.This example assumes that you have configured and authorized a valid SharePoint Online Account (see SharePoint Online Account).
The following screenshot displays the settings of the SharePoint Online Create Item Permission Snap.
After successfully validating/executing the aboveSnap, the results display in thefollowingoutput preview.