API operational
All platform guides
Platform guide

TikTok

The account must authorize upload and publishing permissions. Available privacy levels follow the account’s current settings.

available2,200 characters35 media items

Capabilities at a glance

AnalyticsSupportedCommentsNot availableMessagesNot availableRemote deletionNot availableToken refreshSupported
01

Connect TikTok

Create the hosted connection URL on your server. The customer completes OAuth or the provider-specific credential form directly on PostGate.

Connection requestPostGate API
curl -X POST https://postgate.studio/api/profiles/connect \
  -H "Authorization: Bearer $POSTGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "platform": "tiktok",
  "profile_group_id": "grp_acme123",
  "return_url": "https://app.example.com/settings/social"
}'
02

Publish to TikTok

Use the connected profile ID as the target. Provider-specific fields live under post.options.tiktok so the unified envelope remains stable.

Post envelopePostGate API
{
  "post": {
    "body": "Launch day.",
    "options": {
      "tiktok": {
        "mode": "inbox"
      }
    }
  },
  "profiles": [
    "pro_tiktok123"
  ],
  "media": [
    "med_01JXYZ"
  ]
}
03

Media and content limits

PostGate validates the request at creation and again at delivery. Account-level provider limits can be narrower than the general contract.

Text2,200 characters
LinksNot allowed
Mediaimages and video · Up to 35
Image size20 MB
Video size4 GB
Video duration3 sec–10 min
04

Operational notes

These constraints affect approval, connection health, or delivery behavior for this provider.

  • Direct Post and Creator inbox delivery are available.

  • Creator info and disclosure fields are required.

  • Post analytics are available for public videos after TikTok moderation.

  • Photo posts (carousels) accept 1-35 JPEG/WEBP images; PNG is not supported and photos cannot be mixed with video.

Check live capability before showing the option
Call GET /api/platforms. A provider appears only when it is enabled and configured for the current workspace.
Next guideBuild the complete post envelopeCompareAll platform capabilities