Add a Connection to SFTP in Engini
Prerequisites
- An SFTP server that Engini can reach, and its host name or IP address.
- A username, and either a password or a private key, for an account on that server.
Connecting Engini to SFTP
- Enter your Engini account at https://app.engini.io.
-
Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here.

-
Click on the “New Integration” option located at the top bar.

-
Choose the SFTP option from the available applications.

- Enter the following details in the “New Integration” form and press Save:
Password

- Connection Name - Enter a name that helps identify the SFTP connection.
- Host - Enter the host name or IP address of your SFTP server, for example
sftp.example.com. - Port - Enter the port your SFTP server listens on. The default is 22.
- Authentication Method - Select Password.
- Username - Enter the login name of your SFTP account.
- Password - Enter the password of your SFTP account.
- Save - Click Save to create the connection.
Private Key

- Connection Name - Enter a name that helps identify the SFTP connection.
- Host - Enter the host name or IP address of your SFTP server, for example
sftp.example.com. - Port - Enter the port your SFTP server listens on. The default is 22.
- Authentication Method - Select Private Key.
- Username - Enter the login name of your SFTP account.
- Private Key - Enter the text of your private key, in PEM format.
- Private Key Passphrase - If your private key is protected by a passphrase, enter it here. Leave it empty if the key has no passphrase.
- Save - Click Save to create the connection.
Triggers
Check for New Files
Checks a folder on your SFTP server on a schedule and starts the workflow for each new file it finds.
- Folder - Enter the path of the folder to check, for example
/incoming. The default is/, the root folder. - Starting (UTC) - Select the start date and time for the scheduled trigger.
- Recur every - Choose the time interval for triggering and checking files. The minimum time interval is 15 minutes.
- Add time frame - You can specify a time frame during which the trigger will operate.
- Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Check for New Subfolders
Checks a folder on your SFTP server on a schedule and starts the workflow for each new subfolder it finds.
- Folder - Enter the path of the folder to check, for example
/incoming. The default is/, the root folder. - Starting (UTC) - Select the start date and time for the scheduled trigger.
- Recur every - Choose the time interval for triggering and checking subfolders. The minimum time interval is 15 minutes.
- Add time frame - You can specify a time frame during which the trigger will operate.
- Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Actions
Append to File
Adds content to the end of an existing file on your SFTP server.
- Remote folder path - Enter the path of the folder that holds the file, for example
/home/user. - File name - Enter the name of the file to append to, for example
logfile.txt. - Content to append - Enter the text to add to the end of the file, or the file as a base64 string. You can map it from a previous step.
- File type - Select how the file is handled: Auto Detect, Text or Binary.
Change File Permissions
Changes the permissions of a file on your SFTP server.
- File Path - Enter the full path of the file, for example
/home/user/file.txt. - Permissions - Enter the new permissions as a numeric mode, for example
644.
Create Folder
Creates a new folder on your SFTP server.
- Parent folder path - Enter the path of the folder in which to create the new folder, for example
/home/user. - New folder name - Enter the name of the new folder, for example
archive.
Delete File
Deletes a file from your SFTP server.
- Folder path - Enter the path of the folder that holds the file, for example
/home/user. - File name - Enter the name of the file to delete, for example
report.csv.
Delete Folder
Deletes a folder from your SFTP server.
- Folder path - Enter the path of the folder to delete, for example
/home/user/old.
Get File
Retrieves a file from your SFTP server, including its content.
- File path - Enter the full path of the file, for example
/home/user/file.txt. - File type - Select how the file is handled: Auto Detect, Text or Binary.
- Encoding - Select the text encoding used to read the file. This applies to text files. The default is Unicode (UTF-8).
Get Folder Content
Retrieves the list of items in a folder on your SFTP server.
- Folder path - Enter the path of the folder. The default is
/, the root folder. - Content type - Choose what to return: Files and Folders, Files, or Folders. The default is Files and Folders.
Move File
Moves a file to another folder on your SFTP server.
- Source path - Enter the path of the folder that holds the file, for example
/home/user. - File name - Enter the name of the file to move, for example
report.csv. - Destination path - Enter the path of the folder to move the file to, for example
/home/user/archive.
Rename File
Renames a file on your SFTP server.
- Folder path - Enter the path of the folder that holds the file, for example
/home/user. - File name - Enter the current name of the file, for example
report.csv. - Rename to - Enter the new name of the file, for example
report-final.csv.
Rename Folder
Renames a folder on your SFTP server.
- Current folder path - Enter the path of the folder to rename, for example
/home/user/old. - New folder name/path - Enter the new name of the folder, for example
archive.
Upload File
Uploads a file to your SFTP server.
- Remote folder path - Enter the path of the folder to upload the file to, for example
/home/user/uploads. - File name - Enter the name for the uploaded file, for example
document.txt. - File content - Enter the text of the file, or the file as a base64 string. You can map it from a previous step.
- File type - Select how the file is handled: Auto Detect, Text or Binary.