The Upload file to SFTP action sends a file from a workflow to an SFTP folder. Use it to copy emails or stored files to your own server, or to a folder on the Kolleno SFTP.
The action is available in workflows on these levels:
Email sent and Email received: the action uploads the email as an .eml file.
File upload: the action uploads the file from Files storage.
Before you start
If you want to upload to your own server, contact Kolleno support to add an API secret for it. The API secret holds the host, port, user name, password or private key, and host key of the server. It can also hold a PGP public key, if you want the files to be encrypted.
You do not need an API secret for the Kolleno SFTP.
Add the action
Open the workflow and add the Upload file to SFTP action.
Check File to send. The workflow level sets this field, and you cannot change it.
In Destination, select Kolleno SFTP or External SFTP.
If you selected External SFTP, select the API secret of your server.
Enter the Folder path. For the Kolleno SFTP, the path starts at your company folder. If you leave it empty, the file goes to the root folder.
Enter the File name. If the name has no extension, Kolleno adds .eml, .pdf or the extension of the original file.
Save the workflow.
You can use smart fields in the folder path and the file name, for example {{ customer.ref }}. See Smart fields in the Upload file to SFTP action.
Add a metadata file (optional)
You can upload a second file with details about the main file, for example for a document management system.
Turn on Also upload a metadata file.
Select the Format: JSON or XML.
Write the Metadata template. You can use smart fields in it.
Optionally, enter a Metadata file name. If you leave it empty, Kolleno uses the name of the main file with .json or .xml.
Kolleno uploads the metadata file to the same folder, after the main file.
Where to see the files on the Kolleno SFTP
Go to Settings > Accounting, find CSV via SFTP and click Browse SFTP. You must have permission to manage the company to see this button. See Browse, upload and delete files in your SFTP folder.
Common questions
What happens if a file with the same name is already in the folder?
Kolleno keeps the old file. The new file gets a number in its name, for example INV-001_1.pdf.
What happens if the record has no file?
Kolleno skips the upload for that record, and the record moves to the next step of the workflow.
What happens if the upload fails?
The workflow records the failure on this step. It tries the upload again according to the retry settings of the workflow.


