---
title: "Create a video creative draft and multipart upload for your rendered MP4, MOV or WebM. Returns ad_id, asset_id, upload_id, key and part_size. Upload actual bytes directly with signed URLs; this tool does not generate or render video."
method: POST
path: "/v1/agent/videos"
---

# Create a video creative draft and multipart upload for your rendered MP4, MOV or WebM. Returns ad_id, asset_id, upload_id, key and part_size. Upload actual bytes directly with signed URLs; this tool does not generate or render video.

`POST /v1/agent/videos`

## Request

- Base URL: `https://api.nowyourlink.com`
- URL: `https://api.nowyourlink.com/v1/agent/videos`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.nowyourlink.com/oauth/authorize`, token URL `https://api.nowyourlink.com/oauth/token`, scopes: `creatives:write`)

Create a video creative draft and multipart upload for your rendered MP4, MOV or WebM. Returns ad_id, asset_id, upload_id, key and part_size. Upload actual bytes directly with signed URLs; this tool does not generate or render video.

## Request body

- object
  - `mime` 'video/mp4' | 'video/quicktime' | 'video/webm', required
  - `content_length` integer, required

## Response `200`

Create a video creative draft and multipart upload for your rendered MP4, MOV or WebM. Returns ad_id, asset_id, upload_id, key and part_size. Upload actual bytes directly with signed URLs; this tool does not generate or render video.

- object

## Other responses

- `400`: Invalid arguments or media.
- `401`: The bearer token is missing, expired or invalid. A missing Authorization header returns an empty body.
- `403`: Missing scope, inactive account, ownership or consent failure.
- `404`: No owned record exists for this identifier.
- `405`: The path exists but does not accept this method (agent.method-not-allowed).
- `409`: The current account or creative state blocks this operation.
- `422`: Verification or media validation failed.
- `429`: This grant's 120-per-minute token bucket is empty. Wait Retry-After seconds before retrying.
- `503`: A dependency failed; read current state before retrying a mutation.

---

[API](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api.md) · [All operations](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nowyourlink/apis/nowyourlink-public-spotlight-api/revisions/cd8408529b48?raw)