Posts Overview

Overview

The Posts API allows you to create and schedule content across multiple social media platforms from a single endpoint.

Supported Platforms

Platform	Endpoint	Content Limit
Instagram	`/v1/posts/instagram`	2,200 characters
LinkedIn	`/v1/posts/linkedin`	3,000 characters
X (Twitter)	`/v1/posts/x`	280 characters
Threads	`/v1/posts/threads`	500 characters

Authentication

All Posts API endpoints require authentication via API key:

Authorization: Bearer stover_pk_your_api_key

Common Fields

All platforms share these fields:

Field	Type	Description
`user_id`	UUID	Your user ID (must match API key owner)
`title`	string	Internal title for organization (max 200 chars)
`status`	enum	`draft`, `scheduled`, `published`, `failed`
`scheduled_date`	ISO 8601	When to publish (for scheduled posts)
`hashtags`	string[]	Hashtags without # prefix
`media_urls`	string[]	URLs of media to attach

Post Status Workflow

Status	Description
`draft`	Saved but not scheduled
`scheduled`	Will be published at `scheduled_date`
`published`	Successfully posted to platform
`failed`	Publishing failed (check error logs)

Rate Limiting

Limit	Value
Requests per minute	30
Max payload size	50KB

Platform-Specific Documentation

Instagram

Feed posts, Reels, and Carousels

Professional content sharing

X (Twitter)

Tweets with media and mentions

Threads

Text, images, videos, and carousels

Overview

Contacts

Posts

Webhooks

Overview

Supported Platforms

Authentication

Common Fields

Post Status Workflow

Rate Limiting

Platform-Specific Documentation

Instagram

LinkedIn

X (Twitter)

Threads

​Overview

​Supported Platforms

​Authentication

​Common Fields

​Post Status Workflow

​Rate Limiting

​Platform-Specific Documentation

Instagram

LinkedIn

X (Twitter)

Threads

Overview

Supported Platforms

Authentication

Common Fields

Post Status Workflow

Rate Limiting

Platform-Specific Documentation