Platform Parameters Reference

This document details the platform-specific parameters, media constraints, and post formats available for each supported social network.

Using platform parameters

Pass platform-specific options in the platforms object when creating a post:

{
  "post": {
    "body": "My post content"
  },
  "profiles": ["instagram", "youtube"],
  "media": ["https://example.com/video.mp4"],
  "platforms": {
    "instagram": {
      "format": "reel",
      "first_comment": "Link in bio!"
    },
    "youtube": {
      "title": "My Video Title",
      "privacy_status": "public"
    }
  }
}

---

Facebook

Formats

Format	Description
post	Feed post (default)
reel	Facebook Reel
story	Facebook Story

Feed post parameters

Parameter	Type	Required	Description
format	string	No	Set to "post" (default)
first_comment	string	No	Comment to add after posting
page_id	string	Yes	Page ID when you have multiple pages. Leave blank if you only have one page

Character limit: 63,206 characters

Reel parameters

Parameter	Type	Required	Description
format	string	Yes	Set to "reel"
title	string	No	Title of the reel
page_id	string	Yes	Page ID when you have multiple pages. Use /api/profiles/:id/placements to get available pages

Character limit: 2,200 characters

Story parameters

Parameter	Type	Required	Description
format	string	Yes	Set to "story"
page_id	string	Yes	Page ID when you have multiple pages. Use /api/profiles/:id/placements to get available pages

Media constraints

Feed post

Media Type	Max Size	Formats	Max Count	Duration
Image	10 MB	jpg, png, gif, webp	10	-
Video	4 GB	mp4, mov	1	1s - 4 hours

• Text content: Optional
• Media required: No
• Mix video and image: No
• Minimum image dimensions: 200x200 pixels

Reel

Media Type	Max Size	Formats	Max Count	Duration
Video	300 MB	mp4, mov	1	3s - 60s

• Text content: Optional (caption)
• Media required: Yes (video only)
• Mix video and image: No

Story

Media Type	Max Size	Formats	Max Count	Duration
Image	10 MB	jpg, png	1	-
Video	4 GB	mp4, mov	1	3s - 60s

• Text content: Not allowed
• Media required: Yes
• Mix video and image: No
• Minimum dimensions: 500x500 pixels

Example

{
  "platforms": {
    "facebook": {
      "format": "post",
      "first_comment": "What do you think? Let us know!",
      "page_id": "123456789"
    }
  }
}

---

Instagram

Formats

Format	Description
post	Feed post (default)
reel	Instagram Reel
story	Instagram Story

Feed post parameters

Parameter	Type	Required	Description
format	string	No	Set to "post" (default)
first_comment	string	No	Comment to add after posting (max 2,196 characters)
collaborators	array	No	List of collaborator usernames

Character limit: 2,200 characters

Reel parameters

Parameter	Type	Required	Description
format	string	Yes	Set to "reel"
first_comment	string	No	Comment to add after posting (max 2,196 characters)
cover_url / cover_file	string / file	No	Cover image for the reel. Pass cover_url (URL) in JSON or cover_file (file upload) in multipart. See Cover Images
audio_name	string	No	Name of the audio
trial_strategy	string	No	Trial strategy for trial reels ("MANUAL" or "SS_PERFORMANCE")
collaborators	array	No	List of up to 3 collaborator usernames
thumb_offset	string	No	Thumbnail offset in milliseconds. If both offset and cover_url are provided, cover_url takes precedence

Character limit: 2,200 characters

Story parameters

Parameter	Type	Required	Description
format	string	Yes	Set to "story"

Rate limits

• 100 posts per day per user (24-hour rolling window, across all Instagram formats)
• Instagram can also limit too frequent posting with an error saying “User is performing too many actions”. In this case you need to slow down your posting and wait for some time.

Media constraints

Feed post

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png	10	-
Video	300 MB	mp4, mov	1	3s - 60min

• Text content: Optional (caption)
• Media required: Yes
• Mix video and image: Yes (carousel)
• Minimum dimensions: 200x200 pixels

Reel

Media Type	Max Size	Formats	Max Count	Duration
Image	-	-	0	-
Video	300 MB	mp4, mov	1	3s - 90min

• Text content: Optional (caption)
• Media required: Yes (video only)
• Mix video and image: No

Story

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png	1	-
Video	100 MB	mp4, mov	1	1s - 60min

• Text content: Not allowed
• Media required: Yes
• Mix video and image: No
• Minimum dimensions: 200x200 pixels

Examples

// Feed post with carousel
{
  "platforms": {
    "instagram": {
      "format": "post",
      "first_comment": "Follow for more content!",
      "collaborators": ["username1", "username2"]
    }
  }
}

// Reel
{
  "platforms": {
    "instagram": {
      "format": "reel",
      "first_comment": "Full tutorial on our channel!",
      "cover_url": "https://example.com/thumbnail.jpg",
      "audio_name": "Trending Audio Track",
      "trial_strategy": "MANUAL",
      "collaborators": ["username1", "username2"],
      "thumb_offset": "5000"
    }
  }
}

---

TikTok

Formats

Format	Description
video	Video post (default)
image	Image post (up to 35 images)

Video parameters

Parameter	Type	Required	Description
format	string	No	Set to "video" (default)
privacy_status	string	Yes	Privacy setting for the video
made_with_ai	boolean	No	Mark content as AI-generated
disable_comment	boolean	No	Disable comments
disable_duet	boolean	No	Disable duets
disable_stitch	boolean	No	Disable stitches
brand_content_toggle	boolean	No	Mark video as paid partnership promoting a third-party business
brand_organic_toggle	boolean	No	Mark video as paid partnership promoting your own brand

Character limit: 2,200 characters

Image parameters

Parameter	Type	Required	Description
format	string	Yes	Set to "image"
privacy_status	string	Yes	Privacy setting for the post
photo_cover_index	integer	No	Index (0-based) of photo to use as cover
auto_add_music	boolean	No	Enable automatic music
disable_comment	boolean	No	Disable comments
brand_content_toggle	boolean	No	Mark post as paid partnership promoting a third-party business
brand_organic_toggle	boolean	No	Mark post as paid partnership promoting your own brand

Character limit: 2,200 characters

Privacy status values

Value	Description
PUBLIC_TO_EVERYONE	Visible to all users
MUTUAL_FOLLOW_FRIENDS	Visible to mutual followers
FOLLOWER_OF_CREATOR	Visible to followers only
SELF_ONLY	Private (only you)

Media constraints

Video

Media Type	Max Size	Formats	Max Count	Duration
Video	4 GB	mp4, mov, av, webm	1	3s - 10min

• Text content: Optional (caption)
• Media required: Yes
• Minimum video dimensions: 720x1280 pixels

Image

Media Type	Max Size	Formats	Max Count	Duration
Image	20 MB	jpg, gif	35	-

• Text content: Optional (caption)
• Media required: Yes

Examples

// Video post
{
  "platforms": {
    "tiktok": {
      "format": "video",
      "privacy_status": "PUBLIC_TO_EVERYONE",
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false,
      "made_with_ai": false,
      "brand_content_toggle": false,
      "brand_organic_toggle": false
    }
  }
}

// Image post
{
  "platforms": {
    "tiktok": {
      "format": "image",
      "privacy_status": "PUBLIC_TO_EVERYONE",
      "photo_cover_index": 0,
      "auto_add_music": true
    }
  }
}

---

LinkedIn

Formats

Format	Description
post	Feed post (default)

Parameters

Parameter	Type	Required	Description
organization_id	string	No	Post on behalf of an organization/company page

Character limit: 3,000 characters

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png, gif	20	-
Video	5 GB	mp4, mov, avi	1	0 - 15min
Document	100 MB	pdf, doc, docx, ppt, pptx	1	-

• Text content: Optional
• Media required: No
• Mix video and image: No
• Mix documents with images/videos: No
• Minimum image dimensions: 552x276 pixels
• Document max pages: 300

Example

// Post to personal profile
{
  "platforms": {
    "linkedin": {}
  }
}

// Post to company page
{
  "platforms": {
    "linkedin": {
      "organization_id": "12345678"
    }
  }
}

// Post with document
{
  "post": {
    "body": "Check out our latest report"
  },
  "profiles": ["linkedin"],
  "media": ["https://example.com/report.pdf"],
  "platforms": {
    "linkedin": {
      "organization_id": "12345678"
    }
  }
}

---

YouTube

Formats

Format	Description
post	Channel video (default)

Parameters

Parameter	Type	Required	Description
title	string	No	Video title (max 100 characters)
privacy_status	string	Yes	Video visibility setting
cover_url / cover_file	string / file	No	Custom thumbnail image (requires a verified YouTube account). Pass cover_url (URL) in JSON or cover_file (file upload) in multipart. See Cover Images
made_for_kids	boolean	No	Whether the video is made for kids
tags	array	No	List of tags for the video
category_id	string	No	YouTube video category ID (defaults to "22" / People & Blogs)
contains_synthetic_media	boolean	No	Disclose if the video contains altered or synthetic (AI-generated) content

Character limit: 5,000 characters (description)

Privacy status values

Value	Description
public	Visible to everyone
unlisted	Only accessible via link
private	Only visible to you

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	0	-	0	-
Video	256 GB	mp4, mov, avi, wmv, flv, 3gp	1	1s+

• Text content: Optional (description)
• Media required: Yes (video only)
• Mix video and image: No
• Note: The post body becomes the video description

Example

{
  "platforms": {
    "youtube": {
      "title": "How to Build an API Integration",
      "privacy_status": "public",
      "cover_url": "https://example.com/custom-thumbnail.jpg",
      "made_for_kids": false
    }
  }
}

---

X (Twitter)

Formats

Format	Description
post	Tweet (default)

Parameters

X (Twitter) does not have custom parameters. Content format is determined automatically based on media.

Threads

X supports threads (tweet chains). See the Threads section in the Posts API docs for details.

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	5 MB	jpg, png, webp, gif	4	-
Video	512 MB	mp4, mov	1	1s - 140s

• Text content: Optional
• Media required: No
• Mix video and image: No
• Minimum image dimensions: 4x4 pixels
• Minimum video dimensions: 32x32 pixels
• Character limit: 280 characters (free accounts) or 25,000 characters (paid accounts)

Example

{
  "platforms": {
    "twitter": {}
  }
}

---

Threads

Formats

Format	Description
post	Feed post (default)

Parameters

Threads does not have custom parameters.

Character limit: 500 characters

Threads (Conversations)

Threads supports thread conversations (sequential replies). See the Threads section in the Posts API docs for details.

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	8 MB	jpg, png, gif, webp	20	-
Video	1 GB	mp4, mov	1	0 - 5min

• Text content: Optional
• Media required: No
• Mix video and image: Yes
• Minimum dimensions: 200x200 pixels

Example

{
  "platforms": {
    "threads": {}
  }
}

---

Pinterest

Formats

Format	Description
pin	Pin (default)

Parameters

Parameter	Type	Required	Description
title	string	No	Title of the pin (max 100 characters)
board_id	string	Yes	ID of the board. Use /api/profiles/:id/placements to get available boards
destination_link	string	No	URL of the destination link (max 2,048 characters)
cover_url / cover_file	string / file	No	Cover image (video only). Pass cover_url (URL) in JSON or cover_file (file upload) in multipart. See Cover Images
thumb_offset	integer	No	Thumbnail image offset in seconds (video only)

Character limit: 500 characters (description)

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	32 MB	jpg, gif, png, webp	1	-
Video	2 GB	mp4, mov	1	4s - 15min

• Text content: Optional (description)
• Media required: Yes
• Mix video and image: No

Example

{
  "platforms": {
    "pinterest": {
      "title": "10 Tips for Better Photography",
      "board_id": "987654321",
      "destination_link": "https://example.com/blog/photography-tips"
    }
  }
}

---

Bluesky

Formats

Format	Description
post	Feed post (default)

Parameters

Bluesky does not have custom parameters.

Character limit: 300 characters (graphemes — emoji and combining sequences count as one character on Bluesky’s side).

Threads (conversations)

Bluesky supports thread conversations (sequential replies). See the Threads section in the Posts API docs for details.

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	1 MB	jpg, png, webp, gif	4	-
Video	50 MB	mp4, mov	1	1s - 60s

• Text content: Optional
• Media required: No
• Mix video and image: No

Example

{
  "platforms": {
    "bluesky": {}
  }
}

---

Telegram

Telegram is a bring-your-own-bot integration: each connected profile represents one bot (created via @BotFather) and can publish to any Telegram channel where that bot has been added as administrator. See the Telegram BYO bot guide for the full setup.

Formats

Format	Description
post	Channel post (default)

Parameters

Parameter	Type	Required	Description
chat_id	string	Yes	ID of the destination Telegram chat (channel/group). Use /api/profiles/:id/placements to list channels the bot can post to.
parse_mode	string	No	Message formatting: "HTML" or "MarkdownV2". Omit for plain text.
disable_link_preview	boolean	No	Don’t render a preview for links in the message.
disable_notification	boolean	No	Send the message silently (no notification sound).

Character limit: 4,096 characters

Media constraints

Media Type	Max Size	Formats	Max Count	Duration
Image	10 MB	jpg, png, webp, gif	10	-
Video	50 MB	mp4, mov	10	-
Document	50 MB	pdf, doc, docx, zip, mp3, wav	1	-

• Text content: Optional
• Media required: No
• Mix video and image: Yes (media group)

Example

{
  "post": {
    "body": "Latest update — check it out 👀"
  },
  "profiles": ["telegram"],
  "platforms": {
    "telegram": {
      "chat_id": "-1001234567890",
      "parse_mode": "HTML",
      "disable_link_preview": true
    }
  }
}

---

Google Business

Google Business posts are local updates attached to a specific Business Profile location. Each connected profile may manage multiple Google accounts and any number of locations — every post must specify which location it targets via location_id. List available locations with /api/profiles/:id/placements.

Three formats share the same endpoint: standard local posts, event announcements, and promotional offers. Each format accepts only its relevant parameters — fields are scoped per-format.

Formats

Format	Description
standard	Plain local post (default)
event	Event with a title and date range
offer	Promotion with a validity window and optional coupon

Shared parameters (all formats)

Parameter	Type	Required	Description
format	string	No	standard (default), event, or offer
location_id	string	Yes	Full location resource path (e.g. accounts/123456789/locations/987654321)
language_code	string	No	BCP 47 code (e.g. en, de). Defaults to en. Metadata only — does not translate the body.
cta_action_type	string	No	LEARN_MORE, BOOK, ORDER, SHOP, SIGN_UP, or CALL
cta_url	string	Conditional	HTTPS URL the CTA button opens. Required for every CTA type except CALL.

event format — additional parameters

Parameter	Type	Required	Description
event_title	string	Yes	Event title shown on the local-post card
event_start_date	string	Yes	YYYY-MM-DD
event_end_date	string	Yes	YYYY-MM-DD
event_start_time	string	No	HH:MM in 24-hour format
event_end_time	string	No	HH:MM in 24-hour format

offer format — additional parameters

Parameter	Type	Required	Description
event_start_date	string	Yes	YYYY-MM-DD. Start of the offer validity window.
event_end_date	string	Yes	YYYY-MM-DD. End of the offer validity window.
event_start_time	string	No	HH:MM in 24-hour format
event_end_time	string	No	HH:MM in 24-hour format
event_title	string	No	Offer headline (defaults to "Special Offer" if blank)
offer_coupon_code	string	No	Promo code rendered with the offer
offer_redeem_url	string	No	URL where the offer can be redeemed
offer_terms	string	No	Terms and conditions for the offer

Character limit: 1,500 characters (post body)

Media constraints

Media Type	Max Size	Formats	Max Count	Notes
Image	5 MB	jpg, png	1	Min 400×300 px (recommended 1200×900, 4:3)
Video	—	—	0	Not supported by Google Business local posts

• Text content: Optional
• Media required: No (text-only posts allowed)
• Mix video and image: No
• Categories: certain verticals (e.g. lodging) have local posts disabled by Google and will return a validation error

Examples

standard post with CTA:

{
  "post": {
    "body": "We're now open on Sundays from 10am to 4pm — come visit!"
  },
  "profiles": ["google_business"],
  "platforms": {
    "google_business": {
      "format": "standard",
      "location_id": "accounts/123456789/locations/987654321",
      "cta_action_type": "LEARN_MORE",
      "cta_url": "https://acme.example.com/hours"
    }
  }
}

event post:

{
  "post": {
    "body": "Join us for our 5-year anniversary party — live music, free coffee, prizes."
  },
  "profiles": ["google_business"],
  "platforms": {
    "google_business": {
      "format": "event",
      "location_id": "accounts/123456789/locations/987654321",
      "event_title": "Acme Coffee 5-Year Anniversary",
      "event_start_date": "2026-06-15",
      "event_start_time": "18:00",
      "event_end_date": "2026-06-15",
      "event_end_time": "22:00",
      "cta_action_type": "LEARN_MORE",
      "cta_url": "https://acme.example.com/anniversary"
    }
  }
}

offer post:

{
  "post": {
    "body": "20% off all whole-bean coffee through the end of the month."
  },
  "profiles": ["google_business"],
  "platforms": {
    "google_business": {
      "format": "offer",
      "location_id": "accounts/123456789/locations/987654321",
      "event_start_date": "2026-06-01",
      "event_end_date": "2026-06-30",
      "offer_coupon_code": "BEANS20",
      "offer_redeem_url": "https://acme.example.com/shop",
      "offer_terms": "One per customer. Cannot be combined with other offers."
    }
  }
}

Reviews

Reviews on a Google Business location surface through the Profile Comments API, not the post-level Comments API — reviews live on the location, not on a post. Reply with POST /api/profiles/:profile_id/comments and the review’s external ID as parent_id. Reviews sync twice daily (06:00 and 18:00 UTC).

---

Cross-platform posting tips

Text-only posts

Supported on: Twitter, LinkedIn, Facebook, Threads, Bluesky, Telegram, Google Business

{
  "post": {
    "body": "Exciting announcement coming soon!"
  },
  "profiles": ["twitter", "linkedin", "threads"]
}

Image carousel

Supported on: Instagram, Facebook, Twitter (up to 4), LinkedIn (up to 20), Threads (up to 20), Telegram (up to 10), Bluesky (up to 4)

{
  "post": {
    "body": "Check out these photos!"
  },
  "profiles": ["instagram", "facebook"],
  "media": [
    "https://example.com/photo1.jpg",
    "https://example.com/photo2.jpg",
    "https://example.com/photo3.jpg"
  ]
}

Video content

When posting the same video to multiple platforms, use platform-specific parameters:

{
  "post": {
    "body": "New video is live!"
  },
  "profiles": ["youtube", "tiktok", "instagram"],
  "media": ["https://example.com/video.mp4"],
  "platforms": {
    "youtube": {
      "title": "Tutorial: Getting Started",
      "privacy_status": "public"
    },
    "tiktok": {
      "privacy_status": "PUBLIC_TO_EVERYONE"
    },
    "instagram": {
      "format": "reel"
    }
  }
}

Thread posts

Supported on: X (Twitter), Threads, Bluesky

{
  "post": {
    "body": "1/ Here is a thread about our launch"
  },
  "profiles": ["twitter", "threads"],
  "thread": [
    {
      "body": "2/ First, we built the foundation...",
      "media": ["https://example.com/screenshot.jpg"]
    },
    { "body": "3/ Then we added the features..." },
    { "body": "4/ Check it out at example.com" }
  ]
}

Thread children can also include media arrays. See the Threads section in the Posts API docs for full details.

---

Validation errors

The API validates media against platform constraints before publishing. Common validation errors:

Error	Cause
”Media is required for feed post on Instagram”	Instagram posts need at least one image or video
”Too many images for Feed post on Twitter (max: 4)“	Twitter allows max 4 images
”Content is not allowed for story on Instagram”	Stories don’t support text content
”Cannot mix video and image for feed post on Facebook”	Some platforms don’t allow mixed media
”Documents are not supported for feed post on Twitter”	Platform doesn’t support document uploads
”Too many documents for Feed post on LinkedIn (max: 1)“	LinkedIn allows max 1 document per post
”Cannot mix documents with images or videos for feed post on LinkedIn”	Documents must be posted alone