---
title: "Import From Url"
method: POST
path: "/saved/import"
tags: ["saved"]
---

# Import From Url

`POST /saved/import`

Import a TikTok/Instagram post into a new List.

Creates the list in an `importing` state immediately and kicks off the
Hatchet workflow that fetches the post, extracts its
places, resolves each to a canonical place, and fills the list in — streamed
to the client via `GET /saved/import/{list_id}/stream`.

Instrumented for SigNoz: `import.request` continues the trace the mobile share
extension started (W3C `traceparent`), with `import.dedup` / `import.persist` /
`import.enqueue` sub-spans so the "Saving…" latency is attributable per step.

## Request body

- ImportRequest
  - `url` string, required

## Response `200`

Successful Response

- ImportStartedOut
  - `list_id` string, uuid, required
  - `status` string, required
  - `already_imported` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/eb694aedc555/schema)