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.
Scope TikTok defines as sharing content to the creator's account as a draft to further edit and post in TikTok.
Most pending shares the Content Posting API allows within any 24-hour period, a limit TikTok sets to reduce spam.
Status /business/publish/status/ reports once a draft is uploaded and TikTok has notified the creator's inbox.
Requests each user access token can send to the Content Posting API's upload endpoint.
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 posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent 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:
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_sharewith HTTP 403. - Requests: 6 a minute per user access token, then
rate_limit_exceededwith HTTP 429. - Scope: a token without video.upload gets
scope_not_authorizedwith HTTP 401. - Media:
PULL_FROM_URLfrom a domain or prefix the app has not verified getsurl_ownership_unverifiedwith 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:
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.
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