Platform-Specific Options
The platforms object on POST /posts lets you send per-platform overrides. Only include keys for platforms you want to customize — omitted platforms use sensible defaults.
platforms.instagram
Section titled “platforms.instagram”Instagram-specific overrides. The collab field drives Nuelink’s Co-authoring feature, which tags a partner account as co-author of the post.
| Field | Type | Description |
|---|---|---|
collab | string | Username of the Instagram partner account to invite as a co-author (Instagram Collab). Max 1000 chars. |
location | object | Geotag. Requires id (Instagram’s location ID) and name (display name). |
trialReel | string | Enables Instagram’s Trial Reel feature, which shows the Reel to non-followers first to test performance. Value controls what happens after the 72-hour trial window: MANUAL requires the user to manually share the Reel with their followers from Instagram; SS_PERFORMANCE auto-shares it with followers if it performs well during the trial. |
shareToFeed | boolean | If true, Reels are also shared to the main feed. |
ℹ️ Trial Reel is Instagram-only and video-only. It only applies when the post is a Reel. Setting trialReel on image posts or on non-Instagram channels has no effect.
platforms.facebook
Section titled “platforms.facebook”Facebook-specific overrides. Mirrors the Instagram Collab behavior for Facebook co-authoring.
| Field | Type | Description |
|---|---|---|
location | object | Geotag with id and name. |
TikTok
Section titled “TikTok”platforms.tiktok
Section titled “platforms.tiktok”| Field | Type | Description |
|---|---|---|
sendToInbox | boolean | If true, the scheduled video is delivered to the TikTok app inbox as a notification instead of being auto-published. The user opens the notification on their phone to edit, add music, and publish from the TikTok app. Use this when you want Nuelink to handle scheduling but let the user finalize the post manually in TikTok’s native editor. |
YouTube
Section titled “YouTube”platforms.youtube
Section titled “platforms.youtube”| Field | Type | Description |
|---|---|---|
tags | array | Video tags. Each tag max 255 chars. |
playlists | array | Playlists to add the video to. Each item is { channelId: integer, playlistIds: [string] }. |