Platforms

Platform Configs

Platform-specific configuration options for fine-tuned posting to YouTube, TikTok, Pinterest, Instagram, Facebook and LinkedIn.

Each platform has unique features and settings. Use the config objects below when creating posts to customize behavior per platform.

TikTok

ParameterTypeDescription
connectionIdREQUIREDstringThe account id from /social-accounts this config applies to
titlestringVideo title (max 90 characters)
captionstringVideo caption text (max 2200 characters)
privacyLevelREQUIREDstringPUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
allowCommentsbooleanAllow comments on the video
allowDuetbooleanAllow duets
allowStitchbooleanAllow stitches
sendAsDraftbooleanSend as draft to TikTok app
aiGeneratedbooleanMark as AI-generated content
autoAddMusicbooleanAutomatically add music to the video
brandedContentbooleanMark as branded content
brandedContentOwnBrandbooleanMark as promoting own brand
Example
{
  "tiktokConfigs": [{
    "connectionId": "conn_tiktok_001",
    "title": "Product Demo",
    "privacyLevel": "PUBLIC_TO_EVERYONE",
    "allowComments": true,
    "allowDuet": false,
    "aiGenerated": false
  }]
}

YouTube

ParameterTypeDescription
connectionIdREQUIREDstringThe account id from /social-accounts this config applies to
postTypestringVIDEO or SHORTS
videoTitlestringVideo title (max 100 characters)
tagsstring[]Video tags for discovery (max 20)
privacyStatusstringpublic, unlisted or private
categoryIdstringYouTube category ID
playlistIdstringAdd to playlist after upload
notifySubscribersbooleanNotify subscribers (default true)
allowEmbeddingbooleanAllow embedding on other sites
madeForKidsbooleanMark as made for kids
licensestringyoutube or creativeCommon
Example
{
  "youtubeConfigs": [{
    "connectionId": "conn_yt_001",
    "postType": "VIDEO",
    "videoTitle": "Weekly Product Update",
    "tags": ["product", "update", "tech"],
    "privacyStatus": "PUBLIC",
    "notifySubscribers": true,
    "allowEmbedding": true,
    "madeForKids": false
  }]
}

Pinterest

ParameterTypeDescription
connectionIdREQUIREDstringThe account id from /social-accounts this config applies to
boardIdREQUIREDstringPinterest board ID to pin to
titlestringPin title (max 100 characters)
linkstringDestination URL when pin is clicked
Example
{
  "pinterestConfigs": [{
    "connectionId": "conn_pin_001",
    "boardId": "board_123",
    "title": "Summer Collection 2026",
    "link": "https://example.com/summer-collection"
  }]
}

Instagram

ParameterTypeDescription
connectionIdREQUIREDstringThe account id from /social-accounts this config applies to
postTypestringFEED, REEL or STORY. FEED works with every content type, REEL needs VIDEO, STORY needs IMAGE or VIDEO; any other combination returns 400
trialGraduationstringPublish the reel as a trial reel, shown to non-followers first. MANUAL: you share it to followers in the Instagram app. SS_PERFORMANCE: Instagram shares it if it performs well. Video reels only; omit for a normal reel
collaboratorsstring[]Up to 3 Instagram usernames invited as collaborators (Instagram Collab). A leading @ is removed. Works on feed images, carousels and reels, not on stories or trial reels. Each collaborator accepts the invite in Instagram before the post shows on their profile.

Facebook

ParameterTypeDescription
pageIdREQUIREDstringThe Facebook page this config applies to, as sent in pageIds
postTypestringFEED, REEL or STORY. FEED works with every content type, REEL needs VIDEO, STORY needs IMAGE or VIDEO; any other combination returns 400
videoTitlestringTitle for video posts (max 255 characters)

LinkedIn

ParameterTypeDescription
connectionIdREQUIREDstringThe account id from /social-accounts this config applies to
documentTitlestringTitle shown on a DOCUMENT post (max 100 characters). Defaults to the file name; ignored for other content types
Example
{
  "contentType": "DOCUMENT",
  "mediaUrls": ["https://cdn.adaptlypost.com/.../q3-results.pdf"],
  "linkedinConnectionIds": ["conn_li_001"],
  "linkedinConfigs": [{
    "connectionId": "conn_li_001",
    "documentTitle": "Q3 results"
  }]
}