---
title: Initiate video uploads using TUS
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api/typescript)
[Stream](https://developers.cloudflare.com/api/typescript/resources/stream)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Initiate video uploads using TUS
client.stream.create(StreamCreateParams {account\_id, tusResumable, uploadLength, 3 more } params, RequestOptionsoptions?): void
POST/accounts/{account\_id}/stream
Initiates a video upload using the TUS protocol. On success, the server responds with a status code 201 (created) and includes a `location` header to indicate where the content should be uploaded. Refer to https://tus.io for protocol details.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`Stream Write`
##### ParametersExpand Collapse
params: StreamCreateParams {account\_id, tusResumable, uploadLength, 3 more }
account\_id: string
Path param: The account identifier tag.
maxLength32
Link to this property
tusResumable: "1.0.0"
Header param: Specifies the TUS protocol version. This value must be included in every upload request. Notes: The only supported version of TUS protocol is 1.0.0.
Link to this property
uploadLength: number
Header param: Indicates the size of the entire upload in bytes. The value must be a non-negative integer.
minimum0
Link to this property
direct\_user?: boolean
Query param: Provisions a URL to let your end users upload videos directly to Cloudflare Stream without exposing your API token to clients.
Link to this property
uploadCreator?: string
Header param: A user-defined identifier for the media creator.
maxLength64
Link to this property
uploadMetadata?: string
Header param: Comma-separated key-value pairs following the TUS protocol specification. Values are Base-64 encoded. Supported keys: name, requiresignedurls, allowedorigins, thumbnailtimestamppct, watermark, scheduleddeletion, maxdurationseconds.
Link to this property
[Link to this property](<#(resource)%20stream%20%3E%20(method)%20create%20%3E%20(params)%20default>)
### Initiate video uploads using TUS
TypeScript
HTTPTypeScriptPythonGoTerraform
```
import Cloudflare from 'cloudflare';
const client = new Cloudflare({
apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});
await client.stream.create({
account_id: '023e105f4ecef8ad9ca31a8372d0c353',
'Tus-Resumable': '1.0.0',
'Upload-Length': 0,
});
```
##### Returns Examples