Skip to main content
Learn how to connect Engini to OneDrive. With the OneDrive activities in Engini you can:
  • Create, update, delete, and get one or more files
  • Create, update, delete, and get one or more folders
To get started with the OneDrive app, create an account for free at https://www.microsoft.com.

​
Getting Started with OneDrive

​
Prerequisites

  • A Microsoft account.

​
Add a connection to OneDrive in Engini

  1. Enter to your Engini account at https://app.engini.io.
  2. Navigate to Connections page by clicking on the Connections on the left sidebar or by clicking here.
  3. Click on the “New Integration” option located at the top bar.
  4. Choose the OneDrive option from the available applications.
  5. Enter the following details in the “New Integration” form and press Save:
    1. Connection Name - Enter a unique and descriptive name for this connection. This name will help you easily identify and manage your OneDrive.
    2. Refresh Token - A token used to obtain a new access token when the current one expires.
    3. Sign in with Microsotf - Click on the “Microsoft Signin” button. Sign into your Microsoft account.
    4. Save Settings - Click on the save button to save the connection.

​
Triggers

The triggers monitor the folder, listening for files and folders created or updated in the connected OneDrive folder, based on the defined scheduled intervals.

​
Check for File/Folder Created/Updated

  1. Files or Folders - Select from the dropdown list the type of content you want the trigger to monitor. You can choose between: “Files and Folders”, “Files only”, or “Folders only”.
  2. OneDrive Location - Select the location of the content you want the trigger to monitor. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
  3. Group/Site Id - Enter the Group/Site Id where you want to monitor for new/updated files or folders.
  4. Drive Id - Enter the Drive Id where you want to monitor for new/updated files or folders.
  5. Folder Id - Enter the Folder Id you want to monitor for new/updated files or folders.
  6. Query – Search by file or folder name (not required)
  7. Starting (UTC) - Select the start date and time for the scheduled trigger.
  8. Recur every - Choose the time interval for triggering and checking emails. The minimum time interval is 15 minutes.
  9. Add time frame
    1. Click on the “Add time frames” button.
    2. Select the specific time frame during which you want your workflow to be executed. Simply select the start time and end time that best align with your scheduling preferences.
    3. Press the “Add time frame” button for adding more time frames.

​
Actions

​
Add Permission to File/Folder (Send Invitation)

This activity permits recipients to write, read, or both files or folders by invitation.
  1. Location - Select the location of the file or folder. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Group/Site Id - Enter the Group/Site where you want to give permission.
  3. Drive Id - Enter the drive where you want to give permissions for the file or folder.
  4. File/Folder Id - Enter the file/folder Id you give permissions on.
  5. Recipients - Select the recipients to whom permissions will be given to the file or folder.
  6. Role - Select the roles you want to promote to the recipients.
  7. Require SignIn – Determines whether the recipient must sign in to their account in order to access the file or folder.
  8. Send Invitation – Controls whether a sharing invitation (email with a link) is sent to the recipient when the permission is added.

​
Append to Recipients Array

In this activity, you can add other recipients to the list of recipients. Appending to an array variable allows you to dynamically add new values to the end of the array without changing the size or structure of the array.
  1. Variable - Select the variable from the dropdown list you want to append to the recipients array.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Append to Roles Array

In this activity you can add other roles to the list of roles. Appending to an array variable allows you to dynamically add new values to the end of the array without changing the size or structure of the array.
  1. Variable - Select the variable from the dropdown list you want to append to the recipients array.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Copy File/Folder

In this activity you can copy a file or folder and place them into another folder.
  1. Drive Id - Enter the Drive where you want to copy the file or folder.
  2. File/Folder Id - Enter the file/folder you want to copy.
  3. Target location - Select the location where the file/folder will be copied. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  4. To Drive Id - Select the Drive where the file/folder will be copied.
  5. To Folder Id - Enter the folder where the file/folder will be copied.
  6. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Create Folder

This activity creates a new folder in OneDrive.
  1. Location - Select the location of the new folder. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Folder name - Enter the name of the new folder.
This activity creates a new shared link in OneDrive.
  1. Location - Select the location of the new share link. you can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Type - Select the type of the new share link. you can choose between: “Edit”, “Embed”, or “View”.
    • Edit – anyone with this link can edit this file/folder.
    • Embed – URL that allows access to the file/folder stored in OneDrive, which can be incorporated into other platforms or documents.
    • View – anyone with this link can view this file/folder.
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Delete File/Folder

This activity deletes files or folders from OneDrive.
  1. Location - Select the location of the file/folder you want to delete. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Group/Site Id - Select the Group/Site where the file/folder you want to delete.
  3. Drive Id - Select the Drive where the file/folder will be deleted.
  4. File/Folder Id - Select the file/folder you want to delete.

​
Delete File/Folder Permission

This activity deletes permission from the file/folder from OneDrive.
  1. Location - Select the location of the file/folder you want. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Group/Site Id - Select the Group/Site where the file/folder you want.
  3. Drive Id - Select the Drive where the file/folder.
  4. File/Folder Id - Select the file/folder you want.
  5. Permission Id - Select the permission you want to delete.

​
Download File

This activity allows you to download a file from OneDrive.
  1. Location - Select the location of the file you want to download. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Group Id - Select the Group/Site where the file you want.
  3. Drive Id - Select the Drive where is the file.
  4. File Id - Select the file/folder you want.
  5. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Get Drives

This activity allows you to get drives from OneDrive.
  1. OneDrive Location - Select the location of the file you want to download. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Group Id - Select the Group/Site where the file you want.

​
Get File/Folder Info

This activity allows you to get information on files/folders from OneDrive.
  1. Location - Select the location of the file/folder you want. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Group Id - Select the Group/Site where the file/folder you want.
  3. Drive Id - Select the Drive where the file/folder is.
  4. File/Folder Id - Select the file/folder you want.

​
Get Files/Folders

This activity allows you to get files/folders from OneDrive.
  1. Files or Folders - Select the type of content you want to get. You can choose between: “Files and Folders”, “Files only”, or “Folders only”.
  2. OneDrive Location - Select the location of the content you want to get. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
  3. Group Id - Enter the Group/Site Id you want the content from them.
  4. Drive Id - Enter the Drive Id you want the content from them.
  5. Folder Id - Enter the Folder Id you want the content from them.
  6. Query – Search by file or folder name (not required).

​
Get Permissions

This activity allows you to get permissions of files/folders from OneDrive.
  1. Location - Select the location of the file/folder you want the permissions of. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  2. Group Id - Select the Group/Site where the file/folder you want the permissions of.
  3. Drive Id - Select the Drive where the file/folder the permissions of.
  4. File/Folder Id - Select the file/folder you want the permissions of.

​
Get User Drive

This activity allows you to get the user of OneDrive.

​
Initialize Recipients Array

This activity allows you to initialize the recipients array.
  1. Variable Name - Enter the name of the variable that will hold the initialized object array. This name will be used throughout the workflow whenever you refer to this object array.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Initialize Roles Array

This activity allows you to initialize the roles array.
  1. Variable Name - Enter the name of the variable that will hold the initialized object array. This name will be used throughout the workflow whenever you refer to this object array.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Move File/Folder

This activity allows you to move files/folders in OneDrive.
  1. Drive Id - Enter the Drive from where you want to move the file or folder.
  2. File/Folder Id - Enter the file/ folder Id you want to move the file or folder.
  3. Target location - Select from the dropdown list the location where the file/folder will be moved. You can choose between: “Groups’ Drive”, “My Drive”, or “Site’s Drive”.
  4. To Group Id – Select the Microsoft 365 Group that owns the destination drive.
  5. To Drive Id - Select the Drive where the file/folder will be moved.
  6. To Folder Id - Enter the folder where the file/folder will be moved.
  7. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Rename File/Folder

This activity allows you to rename files/folders in OneDrive.
  1. Files or Folders - Select the type of content you want to get. You can choose between: “File” or “Folder”.
  2. Location - Select the location of the content you want to rename. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
  3. Group Id - Enter the Group/Site Id where the content you want to rename is.
  4. Drive Id - Enter the Drive Id where the content you want to rename is.
  5. File/Folder Id - Enter the File/Folder Id you want to rename.
  6. New name - Enter the new name of the File/Folder.

​
Update File/Folder Permission

  1. Location - Select the location where you to upload the file. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
  2. Permission Id – The unique ID of the existing permission that you want to update (for example, a specific user’s or group’s access to the file or folder).
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

​
Upload File

This activity allows you to upload files/folders in OneDrive.
  1. Location - Select the location where you to upload the file. You can choose between: “Groups’ Drive”, “My Drive”, “Shared With Me”, or “Site’s Drive”.
  2. Group Id - Enter the Group/Site Id where you want to upload the file.
  3. Drive Id - Enter the Drive Id where you want to upload the file.
  4. Folder Id - Enter the Folder where you want to upload the file.
  5. File name - Enter the name of the File you want to upload.
  6. Content - Enter the File you want to upload in base64 string.
  7. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.