Post → Create
AI-generatedSummary
Publishes or schedules text-only or media-rich posts to social media platforms via ClipMint.
Inputs
- platform (required) — The social media platform to post to (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Facebook, Pinterest).
- content (required) — The text content or caption for the post.
- mediaSource — Determines how media is attached: 'none' for text-only, 'clipId' to use an existing ClipMint clip, or 'externalUrl' to import from a third-party video URL.
- clipId — ClipMint clip ID to attach to the post. Required when 'mediaSource' is set to 'clipId'.
- externalVideoUrl — URL to an external video (e.g., from Kie.ai or D-ID). Required when 'mediaSource' is set to 'externalUrl'. The video is downloaded to ClipMint before publishing.
- saveToLibrary — Whether to save the imported external video to your ClipMint library for future use. Default is true; only available when using 'externalUrl' media source.
- additionalFields — Optional additional parameters: 'accountId' to specify a posting account, 'title' for platforms like YouTube, and 'scheduledFor' to schedule the post in ISO 8601 format.
Output shape
A single record containing the API response for the published/scheduled post.
The returned data represents the status of the post (e.g., 'published', 'scheduled') on the specified platform.
Examples
Example 1: Schedule a YouTube video with a title
Platform: YouTube, Media Source: External Video URL, Save to Library: true, Additional Fields: Title set, Scheduled For set.
Example 2: Publish a text-only post to Twitter/X
Platform: Twitter/X, Media Source: None, Content: 'My latest update!'
Example 3: Publish an Instagram post using an existing clip
Platform: Instagram, Media Source: Clip ID, Clip ID: [existing clip ID], Content: 'Check out this video!'