Create Post
AI-generatedSummary
Create a social media post on selected accounts with optional scheduling and AI enhancements.
Inputs
- brandId (required) — Select the brand to work with
- content (required) — The main text content of your post
- socialProfiles (required) — Select which social media accounts to post to
- postAction (required) — Choose publish, schedule, or save as draft
- scheduleTime (required) — When to publish the post (required when postAction is schedule)
- timezone — Timezone for scheduled posting
- advancedOptions — Additional settings such as AI enhancement, tone, media URLs, platform-specific options, and labels
Output shape
A successful response contains postId, content, platforms count, status, scheduleTime, message, and data; a failure response includes success:false and error details.
The returned object may include additional fields depending on platform settings; pagination is not applicable.
Examples
Example 1: Schedule an AI-enhanced post with media
brandId=123, content='Launch update soon!', socialProfiles=[4,5], postAction='schedule', scheduleTime='2025-01-15T09:30:00Z', timezone='America/New_York', advancedOptions={useAI:true, aiTone='enthusiastic', mediaUrls=['https://example.com/img.jpg'], platformSettings={facebook:{postType:'post', comment:'Great news!'}}
Example 2: Publish immediately without AI
brandId=456, content='Team meeting tomorrow', socialProfiles=[7], postAction='publish', scheduleTime='', timezone='UTC', advancedOptions={useAI:false}