Skip to main content
​
content
string
required
The text content of the post.
​
title
string
Post title. Auto-generated from content (first 100 chars) if omitted.
​
platforms
string[]
required
Platforms to post to. e.g. ["TWITTER", "LINKEDIN"].
​
platform_data
object
Platform-specific overrides keyed by platform name, e.g. { "TWITTER": { "text": "shorter version" } }.
​
media_urls
string[]
URLs of media to attach. The server auto-uploads each URL on publish.
​
upload_ids
string[]
IDs of previously uploaded media to attach (from POST /v1/social/upload or the upload_id field on Media Assets). When provided, skips re-uploading.
​
youtube_type
string
YouTube video type. One of SHORT (default) or VIDEO.
​
publish_now
boolean
If true, the post is published immediately. Default false (creates a draft).
​
scheduled_at
string
ISO 8601 timestamp to schedule the post for future publishing. Ignored if publish_now is true.
​
account_ids
string[]
Specific account UUIDs to post from. If omitted, posts to all connected accounts for the given platforms.
curl -X POST https://api.usenaive.ai/v1/social/posts \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We just launched Naive v2 — the all-in-one API.",
    "platforms": ["TWITTER", "LINKEDIN"]
  }'

{
  "id": "post-uuid",
  "status": "draft",
  "platforms": ["TWITTER", "LINKEDIN"],
  "hint": "Draft created. Publish with POST /v1/social/posts/post-uuid/publish"
}
Cost: 1 credit when publishing (immediately or scheduled). Drafts are free.