Planifly

Create a post. This tool can publish externally: confirm the target accounts, final content, audience and timing with the user before scheduling or publishing. `type` controls behavior: 'now' publishes immediately, 'schedule' requires a `date` (ISO 8601), 'draft' saves without queueing. The same `content` is used across every integration in `integrationIds`. Media: Instagram, TikTok, YouTube and Pinterest require at least one media — use list_media/upload_media to get `mediaIds`. `postType` selects the platform format (e.g. instagram_post, instagram_reel, instagram_story, youtube_video, youtube_short, facebook_post, facebook_reel, facebook_story, tiktok_video). `platformSettings` is keyed by platform. For TikTok, ask the user for the intended audience and pass the corresponding privacy value in tiktok.privacy (PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR or SELF_ONLY), subject to the account's allowed options. Do not choose a public audience without user intent. For YouTube pass { youtube: { title, visibility ('public'|'unlisted'|'private'), madeForKids ('yes'|'no') } }. For Pinterest pass { pinterest: { board, title, link } }.

create_post

Permanently delete a post from Planifly and cancel its scheduled publish job. This does not remove content already published on a social platform. Confirm the exact post with the user before deletion.

delete_post

Get account-level metrics for an integration (follower count, engagement rate) plus audience snapshots over the requested period.

get_integration_analytics

Fetch a single post by id, including its content, status, schedule, and platform post id.

get_post

Get engagement metrics for a single post (likes, shares, comments, impressions, reach, video views, etc.). Metrics are cached and may be unavailable for some platforms. If lastSyncedAt is null, zero values are placeholders, not measured zero engagement. Always report the synchronization date and limitations.

get_post_analytics

List all social media accounts (integrations) connected to the workspace. Returns each integration's id, platform, account name, and follower counts.

list_integrations

List the workspace media library (images/videos/gifs, newest first). Use the returned ids as `mediaIds` in create_post. Most platforms (Instagram, TikTok, YouTube, Pinterest) require at least one media.

list_media

List posts in the workspace. Filters: date range (`from`/`to`, ISO 8601), `status` (draft/scheduled/published/failed), `integrationId`. Defaults to 50 most recent.

list_posts

Update an existing post. You can change its `status` (draft <-> scheduled), edit `content`, or reschedule via `date`. Already-published posts are immutable.

update_post

Import an image or video into the media library from a public http(s) URL. Returns the media id to use in create_post `mediaIds`.

upload_media