Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.
/api/v1/postsPOST
Creates a post targeting one or more platforms. Content is per-platform under data.<PLATFORM> (text, media upload IDs, and platform-specific options).
  • status: "SCHEDULED" publishes at postDate — pass the current time to publish immediately.
  • status: "DRAFT" saves without publishing.
Requires an active subscription (402 otherwise). Post and channel limits from your plan are enforced (403 when exceeded).
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Request Bodyapplication/jsonrequired
title *string
Internal post title, shown in dashboards and lists
referenceKey?string | null
Your own idempotency/reference key for looking the post up later
postDate *string
ISO 8601 publish time. Use the current time to publish immediately.
status *"DRAFT" | "SCHEDULED"
SCHEDULED publishes at postDate; DRAFT saves without publishing
socialAccountTypes *"TIKTOK" | "YOUTUBE" | "INSTAGRAM" | "FACEBOOK" | "TWITTER" | "THREADS" | "LINKEDIN" | "PINTEREST" | "REDDIT" | "MASTODON" | "DISCORD" | "SLACK" | "BLUESKY" | "GOOGLE_BUSINESS"[]
Platforms to publish to (the connected account of each platform is used)
data *object
Per-platform content, keyed by platform name
Response
200
id *string
Post ID
title?string
referenceKey?string | null
postDate?string | null
postedDate?string | null
status?"DRAFT" | "SCHEDULED" | "POSTED" | "ERROR" | "DELETED" | "PROCESSING" | "REVIEW" | "RETRYING"
data?object
error?string | null
Top-level failure details
errors?object | null
Per-platform failure details
externalData?object | null
retryCount?number
createdAt?string | null
updatedAt?string | null
400 · Invalid request body, path, or query parameters
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
401 · Missing or invalid API key
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
402
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
subscribeUrl?string
URL to start a subscription
403
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
limit?number
The plan limit that was hit
used?number
Current usage in this billing period
connected?number
Currently connected channels
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
Request example
curl -X POST "https://akarso.co/api/v1/posts" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "referenceKey": "string",
  "postDate": "string",
  "status": "DRAFT",
  "socialAccountTypes": [
    "TIKTOK"
  ],
  "data": {}
}'
Powered byHolocron