Connecting

  • Host: sftp.drop.media, port 22
  • Username: your account prefix
  • Password: an API key that can write files, or sign in with an SSH key you've added on the Developers page

Any SFTP client works, including FileZilla, Cyberduck, WinSCP, sftp and scp. Plain FTP isn't offered.

$ sftp acme@sftp.drop.media
sftp> put chart.png                 # uses your account defaults
sftp> put board.pdf private/        # private
sftp> put draft.png expires-7d/     # deleted after 7 days

$ scp report.pdf acme@sftp.drop.media:private/expires-1d/

Folders set how files are stored

You don't have to create folders first. Upload into a path and its folder names decide what happens to the file:

  • private/ stores it as private, public/ as public.
  • expires-12h/, expires-30d/ and so on delete it after that long.
  • They combine in any order, so private/expires-1d/ and expires-1d/private/ mean the same thing.
  • Any other folder name is ignored and your account defaults apply.

This means a system that can only be given one destination folder can still send private files that clean themselves up.

What happens after an upload

When a file finishes uploading, drop. checks it like any other upload (file type, plan limits, storage) and moves it into your library. The SFTP folder empties as files are stored, so there's nothing to tidy up on the server. If a file can't be stored, for example because it's too big for your plan, the upload fails with the reason, so the sending system knows to try again or raise an alert.

Each stored file starts your webhooks, which is how you get it into the next system along. See running your own code when a file arrives.

Typical senders

  • ERP and accounting systems exporting reports overnight.
  • Product photography studios delivering finished shots.
  • Suppliers sending image packs and spec sheets.
  • Cron jobs and backup scripts on your own servers.

Security

Logins use your API keys or SSH keys, never your account password. Give each sending system its own key with only files:write, so you can revoke one without touching the others. Ten failed logins from one IP address lock that account out over SFTP for 15 minutes.