---
title: "Schedule TikTok publishing"
method: POST
path: "/publishing/tiktok/schedule"
tags: ["Platform"]
---

# Schedule TikTok publishing

`POST /publishing/tiktok/schedule`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/publishing/tiktok/schedule`
- Auth: API key in header `Authorization`

Schedule a completed BlitzReels video or slideshow export, or create a slideshow from ordered workspace image assets. Supports TikTok direct posting and inbox drafts.

## Request body

- object
  - `project_id` string, nullable
  - `export_id` string, nullable
  - `media_asset_ids` string[], nullable
  - `project_name` string, nullable
  - `connection_id` string, nullable
  - `caption` string, nullable
  - `scheduled_for` string, nullable
  - `timezone` string, nullable
  - `publish_mode` 'direct_post' | 'draft', nullable
  - `privacy_level` 'PUBLIC_TO_EVERYONE' | 'FOLLOWER_OF_CREATOR' | 'MUTUAL_FOLLOW_FRIENDS' | 'SELF_ONLY', nullable
  - `allow_comment` boolean, nullable
  - `allow_duet` boolean, nullable
  - `allow_stitch` boolean, nullable
  - `cover_timestamp_ms` integer, nullable
  - `photo_cover_index` integer, nullable
  - `auto_add_music` boolean, nullable
  - `commercial_content_enabled` boolean, nullable
  - `brand_organic` boolean, nullable
  - `branded_content` boolean, nullable
  - `is_ai_generated` boolean, nullable
  - `consent_accepted` boolean, nullable

## Response `200`

Successful response

- object
  - `post_id` string, required
  - `target_id` string, required
  - `platform` 'tiktok', required
  - `status` 'scheduled' | 'publishing' | 'processing' | 'published' | 'draft_sent' | 'retrying' | 'failed' | 'cancelled' | 'manual_required', required
  - `scheduled_for` string, required
  - `connection_id` string, required
  - `export_id` string, required
  - `project_id` string, required
  - `source` 'project_export' | 'media_assets', required
  - `source_media_asset_ids` string[], required
  - `media_type` 'video' | 'photo', required
  - `publish_mode` 'direct_post' | 'draft', required
  - `next_actions` object[], required
    - `method` 'GET' | 'POST' | 'PATCH' | 'DELETE', required
    - `path` string, required
    - `reason` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

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