Skip to main content
POST
Create a new post

Authorizations

X-API-Key
string
header
required

Body

application/json
text
string
required

Post text content

socialMedia
enum<string>
required

Target social media platform

Available options:
TWITTER,
INSTAGRAM,
LINKEDIN,
LINKEDIN_PAGE,
FACEBOOK,
TIKTOK,
YOUTUBE,
THREADS,
WHATSAPP
postType
enum<string>
required

Type of post (IMAGE, VIDEO, CAROUSEL, REEL, STORY, TEXT)

Available options:
TEXT,
IMAGE,
MULTIPLE_IMAGES,
VIDEO,
CAROUSEL,
REEL,
STORY
scheduledAt
string

ISO 8601 date for scheduling (must be in the future)

metaData
object

Platform-specific metadata. A Pinterest post needs boardId, one of the board IDs that GET /v1/accounts/{id}/pinterest/boards returns. A Pinterest post without it is rejected with 400 PINTEREST_BOARD_REQUIRED. Likewise a Dev.to post needs devToTitle (DEV_TO_TITLE_REQUIRED), a Reddit post subreddit and redditTitle (REDDIT_SUBREDDIT_REQUIRED, REDDIT_TITLE_REQUIRED), a WordPress post wpTitle (WORDPRESS_TITLE_REQUIRED) and a Slack post slackChannelIds (SLACK_CHANNEL_REQUIRED).

files
object[]

Media files to attach (use presign-media first to get s3Prefix and fileSrc)

accountId
string

Social account ID to post from

Response

Post created