SFTP Upload

View as Markdown

The Upload node pushes a file from your workflow out to a path on a remote SFTP server. You give it the file from the run and the destination path, and it writes the file there.

When to use it

  • You produced a file in the run and need to deliver it to a partner’s server.
  • You downloaded or built a file and want to place it in a specific directory.
  • You want to hand a file off to a system that picks files up over SFTP.

Inputs

FieldWhat it’s forExample
ServerThe SFTP server to connect to.sftp.example.com
PortThe server’s port, usually 22.22
UsernameThe username to sign in with.automation-user
Password or keyThe password or private key to sign in with, stored as a secret.A Secret reference
Destination pathThe full path on the server to write the file to./inbound/uploads/incoming.csv
FileThe file from the run to upload.A file from a start step or a download

The password or key must reference a workflow Secret. Any field can be a fixed value or an expression that reads from an earlier step.

Outputs

FieldWhat you get back
Path writtenThe path where the file was written on the server.
Bytes transferredHow many bytes were uploaded.

Example

A workflow builds a nightly claims export for Chen Insurance Group and needs to deliver it to the carrier’s SFTP server. It uses Upload to write the file to /inbound/uploads/claims.csv, then follows with a Check step so the run can raise an alert if the delivery did not succeed.

The SFTP Upload node configuration panel, showing the server, destination path, and file.

The destination directory has to exist already and be writable by your username - Upload writes the file, it does not create missing parent folders. If the path is not writable the node hands back a failure you can branch on.