Creating Posts

Use POST /posts/create to create a new post.

Attaching Media

There are two ways to attach media to a post:

1. Upload first -- Upload via POST /media/upload or POST /media/upload-from-url, then pass the returned IDs in the media (or media_ids) field.
2. Inline URLs -- Pass external image/video URLs in the media_urls field. The API will download, process, and attach them automatically. Max 10 URLs.

Both methods can be combined in a single request. Media IDs are validated -- you'll get a 400 error if any ID doesn't exist in your library.

Code
{
  "content": "Check out these photos!",
  "accounts": ["242857_instagram"],
  "media_urls": ["https://example.com/photo.jpg"],
  "media_ids": ["123"]
}

Post Types

Use the type field to specify what kind of post to create:

• post - Regular feed post (default)
• story - Story (Instagram, Facebook)
• reel - Reel/Short (Instagram, Facebook, YouTube, TikTok)