---
title: "Import posts from a social account"
method: POST
path: "/v1/social-accounts/{id}/imports"
tags: ["Social Accounts"]
---

# Import posts from a social account

`POST /v1/social-accounts/{id}/imports`

## Request

- Base URL: `https://api.outstand.so`
- URL: `https://api.outstand.so/v1/social-accounts/{id}/imports`
- Auth: none declared

Enqueues an import job to fetch and store existing posts from the connected social account platform. The job runs asynchronously - poll the returned import ID or listen for an `import.completed` / `import.failed` webhook event.

**Supported networks:** Bluesky, LinkedIn, Facebook, Instagram, Threads, TikTok, YouTube, Pinterest, Google Business

**Note:** LinkedIn post imports are only supported for business (organization) accounts - personal LinkedIn accounts cannot import posts.

**Unsupported:** X (Twitter) - API tier restrictions prevent user timeline access.

**Billing:** Each successfully imported post counts as one `social_posts` usage unit, billed the same day the import runs.

## Path parameters

- `id` string, required

## Request body

- object
  - `since` string, date-time: Import posts published after this ISO 8601 timestamp
  - `until` string, date-time: Import posts published before this ISO 8601 timestamp
  - `limit` integer: Maximum number of posts to import

## Response `202`

Import job created and queued

- object
  - `success` boolean, required
  - `data` object, required: Import job status
    - `id` string, required
    - `orgId` string, required
    - `socialAccountId` string, required
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'partial', required
    - `since` string, nullable, required
    - `until` string, nullable, required
    - `limit` number, nullable, required
    - `imported` number, required
    - `skipped` number, required
    - `failed` number, required
    - `error` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `completedAt` string, nullable, required

## Other responses

- `400`: Invalid request
- `404`: Social account not found
- `500`: Internal server error

---

[API](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1.md) · [All operations](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/revisions/181fad55d031?raw)