---
title: "Import Social Post"
method: POST
path: "/v1/saved/import"
tags: ["mcp-server"]
---

# Import Social Post

`POST /v1/saved/import`

Import an Instagram post/reel or TikTok video into a new saved list.

The same import the iOS share extension starts; the share extension's own
route takes only its `saved:import` token, which OAuth clients never hold.

## Request body

- SocialImportRequest
  - `url` string, required
  - `visibility` 'public' | 'private', nullable

## Response `200`

Successful Response

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

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-24** `1060a62bfafc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stardrift/apis/fastapi/changes/v1/saved/import/post.md)

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/stardrift/apis/fastapi/revisions/dd78fbd6c358?raw)