Creative
Alphacreative_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
Import this public Instagram Reel into my workspace and wait until it is ready to use as a video reference.