---
title: creative_media_imports_create
description: Import a public TikTok or Instagram video into the connected
  workspace when its Creative flag is enabled.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_media_imports_create
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_media_imports_create.md
contentType: reference
---

# creative_media_imports_create

Import a public TikTok or Instagram video into the connected workspace when its Creative flag is enabled.

**Operation** Write. Requires read-and-write OAuth consent.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `body` | object | Yes | Media import input. |
| `body.url` | string | Yes | Public TikTok or Instagram video or Reel URL. |
| `body.get_transcript` | boolean | No | Retrieve a transcript when TikTok provides one. Instagram ignores this field. |
| `body.source_media_url` | string | No | Direct video URL on the source platform CDN. The service can fall back to the post. |
| `body.mode` | string | No | `async` (default), `sync`, `subscribe`, or `webhook`. |
| `body.webhook_url` | string | No | Public HTTPS endpoint for terminal notifications. Required in `webhook` mode. |
| `body.wait_timeout_seconds` | integer | No | HTTP wait for `sync` or `subscribe`, from 0 to 30 seconds. Defaults to 30. |
| `body.project_id` | string | No | Destination project ID in the connected workspace. |
| `idempotency_key` | string | Yes | Reuse this key to retry the same input. |
| `approval_receipt` | string | No | Receipt from the plan. Supply it after confirmation. |

After confirmation, resubmit the same input with its `approval_receipt`. Pass `data.job.id` to `creative_jobs_wait`, then pass `data.media_import_id` as `path.id` to `creative_media_imports_get`. Import uses zero Creative credits.

Use a public video that plays without login. The imported MP4 can be up to 50 MiB and 300 seconds long. A login-protected post fails with `error.code` set to `provider_submission_failed` and `error.public_reason` set to `source_login_required`.

## Sample prompt

```text
Import this public Instagram Reel into my workspace and wait until it is ready to use as a video reference.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
