Quickstart

Prerequisites

Before you begin, make sure you have:

A Social media studio account with at least one connected social account
An API key (see Authentication)

Base URL

All API requests should be made to:

https://api.so-me.studio/v1

Create a post

Send a POST request to create a new post:

curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the API!",
    "socialMedia": "TWITTER",
    "postType": "TEXT"
  }'

socialMedia accepts one of 20 platform values (such as TWITTER, LINKEDIN, INSTAGRAM, FACEBOOK, TIKTOK, YOUTUBE, THREADS, PINTEREST, BLUESKY, and more) — not just the few shown in these examples. See Connecting accounts for the full list of supported platforms.

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "text": "Hello from the API!",
  "socialMedia": "TWITTER",
  "postType": "TEXT",
  "postStatus": "SCHEDULED",
  "createdAt": "2025-01-15T09:00:00.000Z"
}

Schedule a post

To schedule a post for the future, include scheduledAt when creating:

curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Scheduled post!",
    "socialMedia": "LINKEDIN",
    "postType": "TEXT",
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'

Or schedule an existing post:

curl -X POST https://api.so-me.studio/v1/posts/{id}/schedule \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'

List posts

Retrieve your workspace posts with optional filtering. The status filter maps to the postStatus field returned in responses, and socialMedia filters by platform:

curl "https://api.so-me.studio/v1/posts?status=SCHEDULED&socialMedia=TWITTER&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Upload media

For image and video posts, first get a presigned upload URL:

curl -X POST https://api.so-me.studio/v1/posts/presign-media \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postType": "IMAGE",
    "socialMedia": "INSTAGRAM",
    "files": [{
      "filename": "photo.jpg",
      "mimetype": "image/jpeg",
      "size": 1024000
    }]
  }'

Then upload your file to the returned presigned URL and use the s3Prefix and fileSrc in your create post request.

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Prerequisites

Base URL

Create a post

Schedule a post

List posts

Upload media

Next steps

API Reference

MCP Server

​Prerequisites

​Base URL

​Create a post

​Schedule a post

​List posts

​Upload media

​Next steps

API Reference

MCP Server

Prerequisites

Base URL

Create a post

Schedule a post

List posts

Upload media

Next steps