Create Post - Naïve

string

required

The text content of the post.

string

Post title. Auto-generated from content (first 100 chars) if omitted.

string[]

required

Platforms to post to. e.g. ["TWITTER", "LINKEDIN"].

object

Platform-specific overrides keyed by platform name, e.g. { "TWITTER": { "text": "shorter version" } }.

string[]

URLs of media to attach. The server auto-uploads each URL on publish.

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.

string

YouTube video type. One of SHORT (default) or VIDEO.

boolean

If true, the post is published immediately. Default false (creates a draft).

string

ISO 8601 timestamp to schedule the post for future publishing. Ignored if publish_now is true.

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"]
  }'

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 for social, email, domains, and AI media.\n\nShip entire marketing workflows with a single API key.\n\nTry it free: https://usenaive.ai",
    "platforms": ["TWITTER", "LINKEDIN"],
    "media_urls": ["https://media.usenaive.ai/social/media-uuid.png"],
    "publish_now": true
  }'

{
  "id": "post-uuid",
  "status": "draft",
  "platforms": ["TWITTER", "LINKEDIN"],
  "hint": "Draft created. Publish with POST /v1/social/posts/post-uuid/publish"
}

{
  "id": "post-uuid",
  "post_id": "post-uuid",
  "status": "publishing",
  "platforms": ["TWITTER", "LINKEDIN"],
  "scheduled_at": null,
  "hint": "Post queued for immediate publishing. Check status with GET /v1/social/posts/post-uuid"
}

{
  "id": "post-uuid",
  "post_id": "post-uuid",
  "status": "scheduled",
  "platforms": ["TWITTER", "LINKEDIN"],
  "scheduled_at": "2026-06-01T09:00:00Z",
  "hint": "Post scheduled for 2026-06-01T09:00:00Z. Check status with GET /v1/social/posts/post-uuid"
}

Cost: 2.5 credits (+0.5 if it targets X, +5 if that X post contains a link) when publishing (immediately or scheduled). Drafts are free. The X surcharges cover X’s own per-post API charge, which is passed through to us and is far higher for posts containing a link.

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 for social, email, domains, and AI media.\n\nShip entire marketing workflows with a single API key.\n\nTry it free: https://usenaive.ai", "platforms": ["TWITTER", "LINKEDIN"], "media_urls": ["https://media.usenaive.ai/social/media-uuid.png"], "publish_now": true }'

{ "id": "post-uuid", "post_id": "post-uuid", "status": "publishing", "platforms": ["TWITTER", "LINKEDIN"], "scheduled_at": null, "hint": "Post queued for immediate publishing. Check status with GET /v1/social/posts/post-uuid" }

{ "id": "post-uuid", "post_id": "post-uuid", "status": "scheduled", "platforms": ["TWITTER", "LINKEDIN"], "scheduled_at": "2026-06-01T09:00:00Z", "hint": "Post scheduled for 2026-06-01T09:00:00Z. Check status with GET /v1/social/posts/post-uuid" }