FTP Component

Manage files and directories on an FTP server

Component key: ftp

Description

The FTP (File Transfer Protocol) component lets you upload, download, move and delete files on an FTP server.

A common integration pattern involves listing files in a file store, and performing a series of actions on the array of files that are returned. See our looping over files quickstart for information about how to create a loop over an array of files.

FTP Connections

Username, password and endpoint

This component supports basic authentication, meaning that you can enter a username and password for authentication, or if your FTP server allows anonymous access you can leave those values blank.

You can enter either an IP address (e.g. 1.2.3.4) or FQDN (e.g. ftp.example.prismatic.io) for the FTP's host name. Most FTP servers run on port 21 and most FTPS (secure) servers run on port 990, though ports are configurable and server administrators can choose to operate on different ports.

Some FTP servers are secure (indicating that they use FTPS rather than FTP). If you are using plain, unsecured FTP select false for secure (though, we recommend encrypting your connection if possible). If your FTP server is set up to use SSL/TLS, you can select true (meaning use "explicit" FTPS) or implicit to use "implicit" FTPS. For information on "implicit" and "explicit" FTPS, see this documentation.

If your component fails to connect, verify the hostname, port and security information with your server's administrator.

Input	Default	Notes	Example
Input Host string / Required host	Default	Notes The address of the FTP server. This should be an IP address or hostname.	Example ftp.prismatic.io
Input Ignore SSL Errors boolean / Required ignoreSslErrors	Default false	Notes Ignore SSL errors, like self-signed certificates	Example
Input Password password password	Default	Notes	Example p@s$W0Rd
Input Port string / Required port	Default 21	Notes The port of the FTP server.	Example 21
Input Secure string / Required secure	Default false	Notes Specifies whether to use FTPS over TLS. Can be true, false, or implicit, which is for legacy implicit FTPS.	Example false
Input Username string username	Default	Notes	Example john.doe

Actions

Delete File

Delete a file from a FTP server | key: deleteFile

Input	Default	Notes	Example
Input Connection connection / Required connection	Default	Notes	Example
Input Path string / Required path	Default	Notes Path of file to delete	Example /path/to/file.txt
Input Verbose Logging boolean verbose	Default false	Notes Enables verbose logging for debugging purposes.	Example false

---

List Directory

List the contents of a directory | key: listDirectory

Input	Default	Notes	Example
Input Connection connection / Required connection	Default	Notes	Example
Input Path string / Required path	Default	Notes Path of directory on FTP server to list	Example /path/to/directory
Input Verbose Logging boolean verbose	Default false	Notes Enables verbose logging for debugging purposes.	Example false

Output Example Payload

{  "data": [    {      "name": "My Folder",      "type": 2,      "size": 0,      "rawModifiedAt": "Feb  8 22:16",      "permissions": {        "user": 7,        "group": 5,        "world": 5      },      "hardLinkCount": 2,      "group": "group",      "user": "owner",      "isDirectory": true,      "isFile": false,      "isSymbolicLink": false    },    {      "name": "FTP Access.docx",      "type": 1,      "size": 13869,      "rawModifiedAt": "Jan 23 16:38",      "permissions": {        "user": 6,        "group": 4,        "world": 4      },      "hardLinkCount": 1,      "group": "group",      "user": "owner",      "isDirectory": false,      "isFile": true,      "isSymbolicLink": false    }  ]}

---

Move File

Move a file on an FTP server | key: moveFile

Input	Default	Notes	Example
Input Connection connection / Required connection	Default	Notes	Example
Input Destination Path string / Required destinationPath	Default	Notes Path of file to move	Example /my/destination/path.txt
Input Source Path string / Required sourcePath	Default	Notes Path of file to move	Example /my/starting/path.txt
Input Verbose Logging boolean verbose	Default false	Notes Enables verbose logging for debugging purposes.	Example false

---

Read File

Read a file from FTP | key: readFile

Input	Default	Notes	Example
Input Connection connection / Required connection	Default	Notes	Example
Input Path string / Required inputPath	Default	Notes Path of file on FTP server to read data from	Example /path/to/file.txt
Input Verbose Logging boolean verbose	Default false	Notes Enables verbose logging for debugging purposes.	Example false

Output Example Payload

{  "data": {    "type": "Buffer",    "data": [      101,      120,      97,      109,      112,      108,      101    ]  },  "contentType": "application/octet"}

---

Write File

Write a file to FTP | key: writeFile

Input	Default	Notes	Example
Input Connection connection / Required connection	Default	Notes	Example
Input Data text / Required data	Default	Notes Text to write into the file	Example
Input Path string / Required outputPath	Default	Notes Path on FTP server to write file	Example /we/love/commas.csv
Input Verbose Logging boolean verbose	Default false	Notes Enables verbose logging for debugging purposes.	Example false

---