---
title: "Create media asset"
method: POST
path: "/v2/assets"
tags: ["Assets"]
---

# Create media asset

`POST /v2/assets`

## Request

- Base URL: `https://api.synthesia.io`
- URL: `https://api.synthesia.io/v2/assets`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/synthesia/apis/synthesia-api/docs/v2/assets/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a media asset with support for multipart or direct url upload. This endpoint currently supports only the dubbing configuration.

## Request body

- CreateAssetRequest
  - `contentType` 'video/mp4' | 'video/webm' | 'video/quicktime', required: The content type of the asset to upload. Must be one of: video/mp4, video/webm, or video/quicktime.
  - `configuration` DubbingAssetRequestConfiguration, required: Public API configuration for dubbing assets.
    - `name` 'dubbing'
    - `detectLanguage` boolean: Whether to detect the language of the asset.
  - `contentLength` integer, nullable: The length of the file content to upload. This is used to verify the integrity of the asset during upload.
  - `contentMD5` string, nullable: The MD5 hash of the file content to upload. This is used to verify the integrity of the asset during upload.
  - `title` string: The title of the asset to upload.

## Response `201`

Created. Returns upload credentials for the multipart upload.

- CreateAssetMultipartUploadResponse
  - `id` string, required
  - `uploadUrl` string, nullable
  - `uploadCredentials` MultipartUploadCredentialsResponse, required
    - `accessKeyId` string, required
    - `secretAccessKey` string, required
    - `sessionToken` string, required
    - `bucket` string, required
    - `key` string, required

## Other responses

- `400`: Unsupported Media Type.
- `default`: Unexpected Server error.

---

[API](https://skmtc.dev/synthesia/apis/synthesia-api.md) - [All operations](https://skmtc.dev/synthesia/apis/synthesia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synthesia/apis/synthesia-api/revisions/f0f34ae0591d?raw)