Post photos to social platforms
post_photosPublish single photos or carousels to Instagram, TikTok, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Discord, Telegram using local files or public URLs.
Instructions
Publish photo(s) — including carousels — to instagram, tiktok, linkedin, facebook, x, threads, pinterest, bluesky, discord, telegram. Each photo can be a local file path or a public http(s) URL.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | Yes | Upload-post profile identifier whose connected social accounts will be used. | |
| title | No | Default post text / title / caption. Required for YouTube and Reddit; for text posts this IS the post content. | |
| photos | Yes | Photo(s): local file paths or public URLs. Multiple items become a carousel where supported. | |
| timezone | No | IANA timezone for scheduled_date (e.g. 'America/New_York'). Defaults to UTC. | |
| platforms | Yes | Target platform(s). | |
| subreddit | No | Subreddit name without 'r/' — required when platforms includes reddit. | |
| description | No | Extended text (LinkedIn commentary, Facebook/YouTube/Pinterest/TikTok descriptions, Reddit body). | |
| add_to_queue | No | Schedule into the next available queue slot instead. Cannot combine with scheduled_date. | |
| async_upload | No | Return immediately with a request_id and process in background (poll with get_upload_status). | |
| extra_params | No | Any additional platform-specific form fields from the upload-post API docs, passed through verbatim. Examples: {linkedin_title: '...'}, {privacy_level: 'PUBLIC_TO_EVERYONE'}, {media_type: 'REELS'}, {poll_options: ['a','b'], poll_duration: 1440}, {'tags[]': ['tag1','tag2']}. | |
| first_comment | No | Automatically post this as the first comment after publishing. | |
| scheduled_date | No | ISO-8601 date/time to schedule publishing (must be in the future, ≤365 days). Omit to publish now. | |
| facebook_page_id | No | Facebook Page ID — required when platforms includes facebook (auto-detected if only one page). Use list_page_targets to find it. | |
| pinterest_board_id | No | Pinterest board ID — required when platforms includes pinterest. Use list_page_targets to find it. | |
| target_linkedin_page_id | No | LinkedIn organization page ID to post as a company page instead of the personal profile. |