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

# Import Social Post

`POST /v1/saved/import`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/v1/saved/import`
- Auth: none declared

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

[Operation history](https://skmtc.dev/stardrift/apis/stardrift-api/changes/v1/saved/import/post.md)

---

[API](https://skmtc.dev/stardrift/apis/stardrift-api.md) - [All operations](https://skmtc.dev/stardrift/apis/stardrift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stardrift/apis/stardrift-api/revisions/be9ed1e6c38a?raw)