Platform Settings

When creating posts, you can provide platform-specific settings in the platformSpecificData field of each PlatformTarget. This allows you to customize how your content appears and behaves on each social network.

Twitter/X

Create multi-tweet threads with Twitter's threadItems array.

{
  "threadItems": [
    { "content": "🧵 Here's everything you need to know about our API..." },
    { "content": "1/ First, authentication is simple..." },
    { "content": "2/ Next, create your first post..." }
  ]
}

Threads (by Meta)

Similar to Twitter, create multi-post threads on Threads.

Facebook

Constraints:

• ❌ Cannot mix videos and images in the same post
• ✅ Up to 10 images for feed posts
• ✅ Stories require media (single image or video)
• ⚠️ Story text captions are not displayed
• ⏱️ Stories disappear after 24 hours
• 📄 Use pageId to post to multiple Facebook Pages from the same account connection

{
  "contentType": "story",
  "pageId": "123456789"
}

Instagram

Constraints:

• 📐 Feed posts require aspect ratio between 0.8 (4:5) and 1.91 (1.91:1)
• 📱 9:16 images must use contentType: "story"
• 🎠 Carousels support up to 10 media items
• 🗜️ Images > 8MB auto-compressed
• 📹 Story videos > 100MB auto-compressed
• 🎬 Reel videos > 300MB auto-compressed
• 🏷️ User tags: only for single images or first image of carousels (not stories/videos)

{
  "firstComment": "Link in bio! 🔗",
  "collaborators": ["brandpartner", "creator123"],
  "userTags": [
    { "username": "friend_username", "x": 0.5, "y": 0.5 }
  ]
}

LinkedIn

Constraints:

• ✅ Up to 20 images per post
• ❌ Multi-video posts not supported
• 📄 Single PDF document posts supported
• 🔗 Link previews auto-generated when no media attached
• 🏢 Use organizationUrn to post to multiple organizations from the same account connection

{
  "firstComment": "What do you think? Drop a comment below! 👇",
  "disableLinkPreview": false
}

Pinterest

{
  "title": "10 Tips for Better Photography",
  "boardId": "board-123",
  "link": "https://example.com/photography-tips"
}

YouTube

Tag Constraints:

• ✅ No count limit; duplicates are automatically removed
• 📏 Each tag must be ≤ 100 characters
• 📊 Combined total across all tags ≤ 500 characters (YouTube's limit)

Automatic Detection:

• ⏱️ Videos ≤ 3 minutes → YouTube Shorts
• 🎬 Videos > 3 minutes → Regular videos
• 🖼️ Custom thumbnails supported for regular videos only
• ❌ Custom thumbnails NOT supported for Shorts via API
• 👶 madeForKids defaults to false (not child-directed)

{
  "title": "How to Use Our API in 5 Minutes",
  "visibility": "public",
  "madeForKids": false,
  "firstComment": "Thanks for watching! 🙏 Subscribe for more tutorials!"
}

TikTok

⚠️ Required Consent: TikTok posts will fail without content_preview_confirmed: true and express_consent_given: true.

TikTok settings are nested inside platformSpecificData.tiktokSettings:

Constraints:

• 📸 Photo carousels support up to 35 images
• 📝 Video titles: up to 2200 characters
• 📝 Photo titles: auto-truncated to 90 chars (use description for longer text)
• 🔒 privacy_level must match your account's available options (no defaults)

{
  "accountId": "tiktok-012",
  "platformSpecificData": {
    "tiktokSettings": {
      "privacy_level": "PUBLIC_TO_EVERYONE",
      "allow_comment": true,
      "allow_duet": true,
      "allow_stitch": true,
      "content_preview_confirmed": true,
      "express_consent_given": true,
      "description": "Full description here since photo titles are limited to 90 chars..."
    }
  }
}

Google Business Profile

Constraints:

• ✅ Text content + single image only
• ❌ Videos not supported
• 🔗 CTA button drives user engagement
• 📍 Posts appear on Google Search/Maps
• 🗺️ Use locationId to post to multiple locations from the same account connection

{
  "callToAction": {
    "type": "SHOP",
    "url": "https://example.com/store"
  }
}

Telegram

Constraints:

• 📸 Up to 10 images per post (media album)
• 🎬 Up to 10 videos per post (media album)
• 📝 Text-only posts: up to 4096 characters
• 🖼️ Media captions: up to 1024 characters
• 👤 Channel posts show channel name/logo as author
• 🤖 Group posts show "Late" as the bot author
• 📊 Analytics not available via API (Telegram limitation)

{
  "parseMode": "HTML",
  "disableWebPagePreview": false,
  "disableNotification": false,
  "protectContent": true
}

Snapchat

Content Types:

• Story (default): Ephemeral snap visible for 24 hours. No caption/text supported.
• Saved Story: Permanent story saved to your Public Profile. Uses post content as title (max 45 chars).
• Spotlight: Video for Snapchat's entertainment feed. Supports description (max 160 chars) with hashtags.

Constraints:

• 👤 Requires a Snapchat Public Profile
• 🖼️ Media required for all content types (no text-only posts)
• 1️⃣ Only one media item per post
• 📸 Images: max 20 MB, JPEG/PNG format
• 🎬 Videos: max 500 MB, MP4 format, 5-60 seconds, min 540x960px
• 📐 Aspect ratio: 9:16 recommended
• 🔒 Media is automatically encrypted (AES-256-CBC) before upload

{
  "contentType": "saved_story"
}

Bluesky

Bluesky doesn't require platformSpecificData but has important constraints:

Constraints:

• 🖼️ Up to 4 images per post
• 🗜️ Images > ~1MB are automatically recompressed to meet Bluesky's blob size limit
• 🔗 Link previews auto-generated when no media is attached

{
  "content": "Just posted this via the Late API! 🦋",
  "platforms": [
    {
      "platform": "bluesky",
      "accountId": "bluesky-123"
    }
  ]
}

Complete Example

Here's a real-world example posting to multiple platforms with platform-specific settings:

{
  "content": "Excited to announce our new product! 🎉",
  "mediaItems": [
    { "url": "https://example.com/product.jpg", "type": "image" }
  ],
  "platforms": [
    {
      "accountId": "twitter-123",
      "platformSpecificData": {
        "threadItems": [
          { "content": "Excited to announce our new product! 🎉" },
          { "content": "Here's what makes it special... 🧵" }
        ]
      }
    },
    {
      "accountId": "instagram-456",
      "platformSpecificData": {
        "firstComment": "Link in bio! 🔗",
        "collaborators": ["brandpartner"]
      }
    },
    {
      "accountId": "linkedin-789",
      "platformSpecificData": {
        "firstComment": "What features would you like to see next? 👇"
      }
    },
    {
      "accountId": "tiktok-012",
      "platformSpecificData": {
        "tiktokSettings": {
          "privacy_level": "PUBLIC_TO_EVERYONE",
          "allow_comment": true,
          "allow_duet": false,
          "allow_stitch": false,
          "content_preview_confirmed": true,
          "express_consent_given": true
        }
      }
    },
    {
      "accountId": "youtube-345",
      "platformSpecificData": {
        "title": "New Product Announcement",
        "visibility": "public",
        "firstComment": "Thanks for watching! Subscribe for updates! 🔔"
      }
    },
    {
      "accountId": "gbp-678",
      "platformSpecificData": {
        "callToAction": {
          "type": "SHOP",
          "url": "https://example.com/product"
        }
      }
    },
    {
      "accountId": "telegram-901",
      "platformSpecificData": {
        "parseMode": "HTML",
        "disableNotification": false,
        "protectContent": false
      }
    },
    {
      "accountId": "snapchat-234",
      "platformSpecificData": {
        "contentType": "saved_story"
      }
    }
  ]
}