---
title: "Publish Clip"
method: POST
path: "/automation/publish-clip"
---

# Publish Clip

`POST /automation/publish-clip`

## Request

- Base URL: `https://public.reap.video/api/v1`
- URL: `https://public.reap.video/api/v1/automation/publish-clip`
- Auth: HTTP bearer

Immediately publish a completed clip to social media

## Request body

- PublishClipRequest
  - `projectId` string, required: ID of the project containing the clip
  - `clipId` string, required: ID of the clip to publish
  - `integrations` string[], required: List of integration IDs to publish to
  - `title` string, nullable: Post title (defaults to clip title)
  - `description` string, nullable: Post description
  - `tags` string[], nullable: Post tags (max 10)
  - `platformSettings` PlatformSettings
    - `youtube` YouTubeSettings
      - `privacy` 'public' | 'unlisted' | 'private': YouTube video privacy
      - `embeddable` boolean: Allow embedding
      - `publicStats` boolean: Show public statistics
      - `madeForKids` boolean: Mark as made for kids
    - `tiktok` TikTokSettings
      - `privacy` 'public' | 'unlisted' | 'followers' | 'friends' | 'private': TikTok video privacy
      - `disableComments` boolean
      - `disableDuet` boolean
      - `disableStitch` boolean
      - `brandContent` boolean
      - `brandOrganic` boolean
    - `instagram` InstagramSettings
      - `shareToFeed` boolean: Share reel to Instagram feed
    - `linkedin` LinkedInSettings
      - `privacy` 'public' | 'connections' | 'logged_in': LinkedIn post visibility

## Response `200`

Successful response

- AutomationPost
  - `id` string
  - `projectId` string, nullable
  - `clipId` string, nullable
  - `platforms` string[]
  - `successPlatforms` string[]
  - `failedPlatforms` string[]
  - `integrations` string[]
  - `title` string, nullable
  - `description` string, nullable
  - `tags` string[], nullable
  - `status` 'processing' | 'draft' | 'completed' | 'failed' | 'cancelled' | 'unresolved'
  - `scheduleType` 'scheduled' | 'immediate'
  - `scheduleDate` integer
  - `publishDate` integer
  - `urls` object: Social media URLs keyed by integration ID
  - `platformSettings` PlatformSettings
    - `youtube` YouTubeSettings
      - `privacy` 'public' | 'unlisted' | 'private': YouTube video privacy
      - `embeddable` boolean: Allow embedding
      - `publicStats` boolean: Show public statistics
      - `madeForKids` boolean: Mark as made for kids
    - `tiktok` TikTokSettings
      - `privacy` 'public' | 'unlisted' | 'followers' | 'friends' | 'private': TikTok video privacy
      - `disableComments` boolean
      - `disableDuet` boolean
      - `disableStitch` boolean
      - `brandContent` boolean
      - `brandOrganic` boolean
    - `instagram` InstagramSettings
      - `shareToFeed` boolean: Share reel to Instagram feed
    - `linkedin` LinkedInSettings
      - `privacy` 'public' | 'connections' | 'logged_in': LinkedIn post visibility
  - `createdAt` integer
  - `updatedAt` integer

---

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