---
title: "Start a YouTube import"
method: POST
path: "/api/v1/imports/youtube"
tags: ["Sources"]
---

# Start a YouTube import

`POST /api/v1/imports/youtube`

## Request

- Base URL: `https://prismclip.com`
- URL: `https://prismclip.com/api/v1/imports/youtube`
- Auth: HTTP bearer

Import one YouTube video into an owned PrismClip project and return an import job.

## Request body

- object
  - `url` string, uri, required: URL for one YouTube video; playlists are not supported

## Response `200`

The existing import for this account and YouTube video.

- object
  - `import` object, required
    - `jobId` string, uuid, required
    - `projectId` string, uuid, required
    - `provider` 'google_drive' | 'youtube', required
    - `status` string, required
    - `attemptCount` integer, required
    - `maxAttempts` integer, required
    - `errorCategory` string, nullable, required
    - `cancelRequestedAt` string, nullable, required: ISO 8601 timestamp
    - `expectedBytes` integer, nullable, required
    - `byteCount` integer, required
    - `createdAt` string, required: ISO 8601 timestamp
    - `updatedAt` string, required: ISO 8601 timestamp
  - `replayed` boolean, required

## Other responses

- `202`: The remote import was queued.
- `400`: The URL is invalid or does not identify one supported YouTube video.
- `401`: The API key is missing or invalid.
- `403`: The API key lacks projects:write.
- `413`: Provider metadata shows that the source exceeds the remote-source limit.
- `422`: YouTube rejected, restricted, or could not resolve the source.
- `429`: The API-key rate limit was exceeded.
- `503`: Remote import storage, queueing, or the YouTube ingestion provider is unavailable.

---

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