# createUploadUrl (/api/reference/mutations/create-upload-url)

An address to upload one file to, and the key to name it by afterwards. Send the bytes to `uploadUrl` with an HTTP `PUT` and the same content type, then pass `key` to the mutation the file is for. Every key is made under the caller's own workspace (a prospect's video under a platform prefix instead), whatever is sent. Nothing is stored until the file is sent: a repeat makes another key, and an address never used leaves nothing behind. `NOT_CONFIGURED` when file storage is not set up, `FORBIDDEN` for a staff purpose asked by anyone else, and `INVALID_INPUT` for a file type the purpose does not take.

```graphql
createUploadUrl(
  input: CreateUploadUrlInput!
): CreateUploadUrlPayload!
```

### Arguments [#arguments]

#### [`createUploadUrl.input`](#input) · [`CreateUploadUrlInput!`](/api/reference/inputs/create-upload-url-input) `non-null` `input` [#input]
The file's name, type and purpose.

### Type [#type]

#### [`CreateUploadUrlPayload`](/api/reference/objects/create-upload-url-payload) `object` [#createuploadurlpayload-object]
Where to send the file, and what to call it afterwards.