Log inStart Free Trial
easyCoexistence Official APIs

Sending a video to a TikTok creator's drafts through the API

TikTok's APIs send a video to a creator's drafts with the upload flow: the Content Posting API's /v2/post/publish/inbox/video/init/ uploads it under the video.upload scope, and TikTok sends the creator an inbox notification to edit and post it in the app. The API for Business does the same with upload_to_draft on /business/video/publish/, or is_draft on photo posts.

easyCoexistence publishes TikTok videos and photo posts with publish_tiktok_post from Claude, ChatGPT or your own platform, now or at a date and time up to 90 days ahead, with each queued post on the Posts screen until it goes out.

video.upload

Scope TikTok defines as sharing content to the creator's account as a draft to further edit and post in TikTok.

5 pending

Most pending shares the Content Posting API allows within any 24-hour period, a limit TikTok sets to reduce spam.

SEND_TO_USER_INBOX

Status /business/publish/status/ reports once a draft is uploaded and TikTok has notified the creator's inbox.

6 a minute

Requests each user access token can send to the Content Posting API's upload endpoint.

Ignored

What happens to the other post_info fields when upload_to_draft is true on /business/video/publish/.

How does a draft differ from a direct post?

In who presses Post. A direct post goes live once TikTok has processed it; a draft lands in the creator's TikTok inbox, and it is published only when the creator opens it, edits it as they like and posts it. The difference runs through both of TikTok's posting APIs:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent in the call

How does the Content Posting API upload a draft?

With a POST to https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, a user access token holding video.upload, and a source_info object. PULL_FROM_URL has TikTok fetch the video from a domain or URL prefix the app has verified; FILE_UPLOAD returns an upload_url, to which the file is sent in chunks with PUT requests. The returned publish_id goes to /v2/post/publish/status/fetch/, photos use /v2/post/publish/content/init/ with post_mode set to MEDIA_UPLOAD, and TikTok asks apps to tell users to open the inbox notification to continue editing in TikTok:

Upload a video to the creator's inbox from a URL
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
  -H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -d '{
    "source_info": {
      "source": "PULL_FROM_URL",
      "video_url": "https://media.example.com/tiktok/draft.mp4"
    }
  }'

# data.publish_id: pass it to /v2/post/publish/status/fetch/

Which limits apply to Content Posting API drafts?

TikTok documents these on its upload reference, each one returned by the init call when it applies:

  • Pending drafts: at most 5 pending shares within any 24-hour period; past that, spam_risk_too_many_pending_share with HTTP 403.
  • Requests: 6 a minute per user access token, then rate_limit_exceeded with HTTP 429.
  • Scope: a token without video.upload gets scope_not_authorized with HTTP 401.
  • Media: PULL_FROM_URL from a domain or prefix the app has not verified gets url_ownership_unverified with HTTP 403.

How does the API for Business upload a draft?

With its publishing endpoints and one more field in post_info. On /business/video/publish/, upload_to_draft set to true sends the video as a draft, and TikTok ignores the other post_info fields; on /business/photo/publish/, is_draft keeps only the title and caption. Both need video.upload on the account's token, which /tt_user/token_info/get/ lists, and without it the owner approves draft uploading by authorizing the app again. The media still sits on a verified URL, the status reads SEND_TO_USER_INBOX, and the creator finds the draft through the inbox notification:

Send a video to the creator's drafts on the API for Business
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/draft.mp4",
    "post_info": {
      "upload_to_draft": true,
      "is_brand_organic": false,
      "is_branded_content": false
    }
  }'

What does the creator do with the draft?

Finishes it in TikTok. The inbox notification opens the uploaded video or photos in TikTok's editor, where the creator reviews and edits them and posts. On the Content Posting API, the status moves from SEND_TO_USER_INBOX to PUBLISH_COMPLETE once the creator posts from the draft, and TikTok notes that one draft can produce more than one post.

Does easyCoexistence send drafts?

No: publish_tiktok_post publishes. It calls /business/video/publish/ or /business/photo/publish/ without upload_to_draft or is_draft, so a post goes live once TikTok has processed it. To hold a post back for review, schedule it with scheduled_at, from 1 minute to 90 days ahead: it waits under Coming up on the Posts screen, update_scheduled_post changes its time, caption or a photo post's title, and cancel_scheduled_post stops it before it goes out.

Common mistakes

  • Asking for video.publish to send drafts. Drafts need video.upload, the scope TikTok describes as sharing content as a draft.
  • Setting a caption on a video draft through the API for Business. With upload_to_draft true, TikTok ignores the rest of post_info.
  • Uploading drafts faster than creators post them. The Content Posting API stops at 5 pending shares in 24 hours with spam_risk_too_many_pending_share.
  • Leaving users without a pointer to the inbox. TikTok asks apps to tell them to open the inbox notification to finish the post.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Can the TikTok API save a video as a draft?

Yes. The upload flow puts it in the creator's TikTok inbox, where the creator edits and posts it; the token needs the video.upload scope.

Where does a draft sent through the API appear?

In the TikTok app, behind an inbox notification that opens the video in TikTok's editor for the creator to finish.

Can a TikTok draft keep my caption?

On the API for Business, a photo draft keeps its title and caption, while a video draft drops the other post_info fields.

Can one TikTok draft become more than one post?

Yes. TikTok notes that one draft can produce more than one post, and on the Content Posting API the status moves to PUBLISH_COMPLETE once the creator posts from it.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on