---
title: FTP Upload
description: "Upload a file of a chosen size to an FTP server over the SIM's data connection and measure uplink throughput."
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Upload a file of a chosen size to an FTP server over the SIM's data connection and measure uplink throughput.

## Parameters

| Parameter | Required | Description |
| ----------- | ---------- | ------------- |
| Upload link | Yes | FTP URL to upload to. |
| File size | Yes | Size of the generated payload, in bytes. |
| FTP credentials | No | Login for the FTP server. |
| Upload should fail | No | Invert the verdict. |

Plus the shared [connection settings](/tests/actions/cellular/overview#connection-settings) and DNS override (`command.override_dns`, `command.dns`).

## Results and metrics

In the action report (`result`): `throughput_in_kbps`, `md5sum`, `dns_server`, and `duration` in seconds.

In Analytics, each run feeds the FTP upload measurement with `throughput_kbps` and `duration_seconds`, tagged by status, URL, APN, antenna, and access technology.

## What's next?

<Columns cols={2}>
  <Card title="FTP Download" icon="cloud-arrow-down" href="/tests/actions/cellular/ftp-download">

    The downlink direction

</Card>
  <Card title="HTTP Upload" icon="cloud-arrow-up" href="/tests/actions/cellular/http-upload">

    The HTTP equivalent

</Card>
</Columns>