Creative
Alpha

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

ParameterTypeRequiredDescription
bodyobjectYesMedia import input.
body.urlstringYesPublic TikTok or Instagram video or Reel URL.
body.get_transcriptbooleanNoRetrieve a transcript when TikTok provides one. Instagram ignores this field.
body.source_media_urlstringNoDirect video URL on the source platform CDN. The service can fall back to the post.
body.modestringNoasync (default), sync, subscribe, or webhook.
body.webhook_urlstringNoPublic HTTPS endpoint for terminal notifications. Required in webhook mode.
body.wait_timeout_secondsintegerNoHTTP wait for sync or subscribe, from 0 to 30 seconds. Defaults to 30.
body.project_idstringNoDestination project ID in the connected workspace.
idempotency_keystringYesReuse this key to retry the same input.
approval_receiptstringNoReceipt 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.