Platform options

MADIAD Hub forwards any option a platform supports verbatim, so you are never limited to what is listed here. The fields below are the common and important ones. Prefix the field with the platform name where the option is platform-specific (<platform>_<field>). Array fields use the field[] convention — repeat the key once per value.

Every field on this page is optional unless explicitly marked required. Omitting a field uses the platform’s default.

TikTok

Field	Type	Effect
`privacy_level`	String	Who can see the post: `PUBLIC_TO_EVERYONE` (default), `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR`, `SELF_ONLY`
`post_mode`	String	`DIRECT_POST` (default) publishes immediately; `MEDIA_UPLOAD` sends the media to the TikTok creator inbox as a draft so the creator can finish editing in-app. A video draft carries no caption: paste it in the app. Exactly one of these two values; any other value or spelling is refused with `400 invalid_request`, and `MEDIA_UPLOAD` cannot be combined with `scheduled_at` or `add_to_queue`. Needs a TikTok connection whose `capabilities` include `draft`
`auto_add_music`	Boolean	Add background music to a photo post (default `false`)
`tiktok_music_id`	String	A track for a photo post: the `id` of a track from `GET /v1/tiktok/music/trending` (or `/search`). If the profile’s TikTok connection has no music permission, the post goes out (or is saved as a draft) without music and the result carries a `warnings` entry with code `music_not_applied`: reconnect TikTok on that profile. See Warnings
`disable_comment`	Boolean	Disable comments on the post (default `false`)
`disable_duet`	Boolean	Disable Duet on the post (default `false`)
`disable_stitch`	Boolean	Disable Stitch on the post (default `false`)
`brand_content_toggle`	Boolean	Set `true` for a paid partnership promoting a third-party brand (default `false`)
`brand_organic_toggle`	Boolean	Set `true` when promoting the creator’s own business (default `false`)
`photo_cover_index`	Integer	Index of the photo to use as the cover/thumbnail on photo posts (default `0`)
`tiktok_title`	String	Post title for photo posts (≤ 90 chars) — see Character limits
`tiktok_description`	String	Long caption for photo posts (≤ 4,000 chars) — see Character limits

brand_content_toggle and brand_organic_toggle can both be true at the same time — e.g. a creator promoting their own brand in a paid partnership.

curl -X POST https://api.madiad.com/v1/posts/video \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "'"$PROFILE_ID"'",
    "platforms": ["tiktok"],
    "caption": "Behind the scenes",
    "video_url": "https://cdn.example.com/clip.mp4",
    "privacy_level": "FOLLOWER_OF_CREATOR",
    "disable_duet": true
  }'

Instagram

Field	Type	Effect
`media_type`	String	`IMAGE` (default) or `STORIES`; mixed media is handled automatically as a carousel or reel
`collaborators`	String	Comma-separated collaborator usernames to invite as co-authors
`user_tags`	String (JSON)	Tag users on a photo; requires a JSON-encoded array of `{username, x, y}` where `x` and `y` are floats 0.0–1.0 representing position on the image
`location_id`	String	Instagram location id to attach to the post
`instagram_first_comment`	String	Auto-post a comment immediately after publishing — see First comment

  -F "media_type=STORIES" \
  -F 'user_tags=[{"username":"jane_doe","x":0.5,"y":0.3}]' \
  -F "location_id=213385402"

Facebook

Field	Type	Effect
`facebook_page_id`	String	Required when the profile has more than one Facebook Page — selects which Page to post to (auto-selected when there is only one)
`facebook_media_type`	String	`REELS` (default — 9:16, ≤ 90 s; longer video is trimmed to 90 s), `STORIES` (24-hour ephemeral), or `VIDEO` (normal Page video — any aspect ratio, up to 4 hours, supports a custom thumbnail)
`thumbnail_url`	String	Custom thumbnail URL — only applies when `facebook_media_type=VIDEO`
`video_state`	String	`PUBLISHED` (default) or `DRAFT` — staging a Page video for manual publishing
`facebook_description`	String	Long-form description displayed beneath the video
`facebook_first_comment`	String	Auto-post a first comment immediately after publishing (Page posts only) — see First comment

facebook_page_id is ignored while a Page is pinned to the profile — the post goes to the pinned Page and still reports success. See Pin a Page to a profile.

To publish a long-form Page video (portrait or landscape, any length up to 4 hours), set facebook_media_type=VIDEO. Without it the default is REELS, which caps the video at 90 seconds.

  -F "facebook_media_type=VIDEO" \
  -F "thumbnail_url=https://cdn.example.com/thumb.jpg" \
  -F "facebook_description=Full walkthrough — watch all the way through."

YouTube

Field	Type	Effect
`privacyStatus`	String	`public` (default), `unlisted`, or `private`
`tags[]`	Array	Video tags (repeat the key once per tag)
`categoryId`	String	YouTube category id (default `"22"` — People & Blogs)
`selfDeclaredMadeForKids`	Boolean	Declare the video is made for kids (default `false`)
`embeddable`	Boolean	Allow the video to be embedded on other sites (default `true`)
`license`	String	`youtube` (default) or `creativeCommon`
`defaultLanguage`	String	BCP-47 language code for the video metadata (e.g. `"en"`, `"vi"`)
`defaultAudioLanguage`	String	BCP-47 language code for the video audio track
`thumbnail`	File	Custom thumbnail uploaded as a binary file (JPG/PNG/GIF/BMP, ≤ 2 MB; not supported on Shorts)
`thumbnail_url`	String	Custom thumbnail by public URL (same format restrictions as `thumbnail`)
`youtube_subtitle_file`	File	SRT or VTT subtitle file to upload
`youtube_subtitle_language`	String	BCP-47 language code for the subtitle track — required when `youtube_subtitle_file` is set
`youtube_subtitle_name`	String	Display name for the subtitle track
`youtube_title`	String	Video title (≤ 100 chars) — see Character limits
`youtube_description`	String	Video description (≤ 5,000 chars) — see Character limits

  -F "privacyStatus=unlisted" \
  -F "tags[]=tutorial" \
  -F "tags[]=coffee" \
  -F "categoryId=26" \
  -F "thumbnail=@./thumb.jpg" \
  -F "youtube_subtitle_file=@./captions.srt" \
  -F "youtube_subtitle_language=en" \
  -F "youtube_subtitle_name=English (auto)"

Field	Type	Effect
`pinterest_board_id`	String	Required — every pin must go to a board
`pinterest_link`	String	Destination URL the pin links to
`pinterest_alt_text`	String	Accessibility alt text for the image
`pinterest_cover_image_url`	String	Cover image URL for video pins
`pinterest_title`	String	Pin title (≤ 100 chars) — see Character limits
`pinterest_description`	String	Pin description (≤ 500 chars) — see Character limits

  -F "pinterest_board_id=123456789" \
  -F "pinterest_link=https://example.com/product" \
  -F "pinterest_alt_text=Flat-lay of our new blend"

Field	Type	Effect
`subreddit`	String	Required — target subreddit without the `r/` prefix
`reddit_title`	String	Post title, separate from the body; falls back to `caption` if omitted — see Character limits
`flair_id`	String	Flair id to apply to the post
`first_comment_media[]`	File(s)	Images to attach to the first comment (Reddit-only) — see First comment

  -F "subreddit=coffee" \
  -F "reddit_title=My home roast — first attempt" \
  -F "flair_id=abc123" \
  -F "first_comment_media[]=@./roast-detail.jpg"

X (Twitter)

Field	Type	Effect
`poll_options[]`	Array	2–4 poll choices, ≤ 25 chars each — mutually exclusive with `quote_tweet_id`
`poll_duration`	Integer	Poll duration in minutes (5–10,080; default `1440` = 24 h)
`reply_settings`	String	Who can reply: `following`, `mentionedUsers`, `subscribers`, or `verified`
`quote_tweet_id`	String	Quote an existing tweet by id (cannot be combined with media)
`reply_to_id`	String	Post the tweet as a reply to this tweet id
`community_id`	String	Post to a specific X Community
`x_long_text_as_post`	Boolean	Publish long text as a single post (X Premium) instead of auto-threading (default `false`)
`x_thread_image_layout`	String	Comma-separated list of how many images appear per tweet in a threaded post (each value 0–4, total must equal the number of images) — e.g. `"0,4"`
`tagged_user_ids[]`	Array	Tag up to 10 users in the media by their user id
`geo_place_id`	String	Attach a geographic place id to the post

X strips any URL that would become a clickable link from the post text before publishing — see Character limits. Put links in your profile bio or inside the image/video instead.

  -F "poll_options[]=Light roast" \
  -F "poll_options[]=Dark roast" \
  -F "poll_options[]=No preference" \
  -F "poll_duration=4320" \
  -F "reply_settings=following"

Threads

Field	Type	Effect
`threads_long_text_as_post`	Boolean	Publish long text as a single post instead of auto-threading (default `false`)
`threads_thread_media_layout`	String	Comma-separated list of how many media items appear per post in a thread (each value 0–10, total must equal the number of files) — e.g. `"0,5"`
`threads_topic_tag`	String	One topic tag, 1–50 chars, no `"."` or `"&"` — helps with reach

  -F "threads_topic_tag=coffeetime" \
  -F "threads_long_text_as_post=true"

Field	Type	Effect
`visibility`	String	Post visibility (`PUBLIC`)
`target_linkedin_page_id`	String	Publish to an organization Page instead of the personal profile
`linkedin_link_url`	String	A link to attach to the post
`linkedin_first_comment`	String	Auto-post a first comment — see First comment

  -F "target_linkedin_page_id=urn:li:organization:12345678" \
  -F "linkedin_link_url=https://example.com/launch" \
  -F "visibility=PUBLIC"

target_linkedin_page_id takes the full urn:li:organization:… URN. List the organizations a profile can publish as with GET /v1/connections/linkedin/pages — see LinkedIn Pages. It is ignored while an organization Page is pinned to the profile; see Pin a Page to a profile.

Bluesky

Field	Type	Effect
`bluesky_link_url`	String	A link to attach to the post

  -F "bluesky_link_url=https://example.com/post"

Google Business

Google Business Profile posts appear on your Google Maps listing and in Search. The gbp_ prefix scopes all options to this platform.

Field	Type	Effect
`gbp_topic_type`	String	`STANDARD` (default), `EVENT`, or `OFFER`
`gbp_cta_type`	String	CTA button: `BOOK`, `ORDER`, `SHOP`, `LEARN_MORE`, `SIGN_UP`, or `CALL`
`gbp_cta_url`	String	URL for the CTA button — required when `gbp_cta_type` is set
`gbp_location_id`	String	Which location to post to — auto-selected when the account has exactly one location

Event fields (when gbp_topic_type=EVENT):

Field	Type	Effect
`gbp_event_title`	String	Required — event name
`gbp_event_start_date`	String	Required — start date in `YYYY-MM-DD` format
`gbp_event_end_date`	String	Required — end date in `YYYY-MM-DD` format
`gbp_event_start_time`	String	Start time in 24-hour `HH:MM` format
`gbp_event_end_time`	String	End time in 24-hour `HH:MM` format

Offer fields (when gbp_topic_type=OFFER):

Field	Type	Effect
`gbp_coupon_code`	String	Coupon or promo code
`gbp_redeem_url`	String	URL where the offer can be redeemed
`gbp_terms`	String	Terms and conditions text

# Standard post with a CTA
  -F "gbp_topic_type=STANDARD" \
  -F "gbp_cta_type=LEARN_MORE" \
  -F "gbp_cta_url=https://example.com/menu"

# Event post
  -F "gbp_topic_type=EVENT" \
  -F "gbp_event_title=Grand Opening" \
  -F "gbp_event_start_date=2025-09-01" \
  -F "gbp_event_end_date=2025-09-01" \
  -F "gbp_event_start_time=09:00" \
  -F "gbp_event_end_time=17:00"

Manual-credential channels

Eleven channels connect by pasting your own credential rather than by OAuth — see Channels for the field list and the connect endpoints. They take the shared caption, or a <channel>_caption of their own (see Per-platform overrides); Mastodon and the article platforms have their own rules for that text, below. There are no other creative options, and no analytics data is returned for any of them. Several of them also accept only one kind of post. Sending a channel a kind it does not take is refused locally with 400 invalid_request before anything is published — the matrix on Channels is the reference.

Chat channels

Text over the platform limit is truncated, not rejected, so keep captions within the limits shown in Character limits:

Telegram — 4,096 chars for text-only messages; 1,024 chars for media captions.
Discord — 2,000 chars.
Slack — text posts only.

Fediverse

Mastodon — text, photo and video. The per-post limit is set by the instance you connected: 500 chars by default, and an instance may raise it. A shared caption over 500 is cut to 500 for Mastodon only. To send more to an instance that allows it, set mastodon_caption: it is sent as written and not length-checked, and the instance refuses text over its own limit.
Lemmy — text and photo. The target community is fixed at connect time.
Nostr — text only, relayed to the relays you supplied at connect time.

Publishing surfaces

WordPress — text, photo and video.
dev.to, Hashnode — text only.
Whop — text only, posted to the experience you supplied at connect time.
listmonk — text only, sent to the list you supplied at connect time. This one sends email to real recipients — test against a small list first.

On the article platforms (WordPress, dev.to, Hashnode, Lemmy, listmonk and Whop) the text you send is the article’s body, and its title is taken from the first line unless you set <channel>_title. <channel>_caption replaces the shared caption as that channel’s body and is sent as that channel’s own job — see Per-platform overrides.

Get Started

Concepts

Integrations

API Reference

TikTok

Instagram

Facebook

YouTube

Pinterest

Reddit

X (Twitter)

Threads

LinkedIn

Bluesky

Google Business

Manual-credential channels

Chat channels

Fediverse

Publishing surfaces

​TikTok

​Instagram

​Facebook

​YouTube

​Pinterest

​Reddit

​X (Twitter)

​Threads

​LinkedIn

​Bluesky

​Google Business

​Manual-credential channels

​Chat channels

​Fediverse

​Publishing surfaces

TikTok

Instagram

Facebook

YouTube

Pinterest

Reddit

X (Twitter)

Threads

LinkedIn

Bluesky

Google Business

Manual-credential channels

Chat channels

Fediverse

Publishing surfaces