Authentication

All API requests require authentication using a Bearer token. Generate your API key from the Settings → API Keys section of your dashboard.

POST /api/v1/auth/token

Exchange your API credentials for an access token.

curl -X POST https://api.socialflow.io/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key",
    "api_secret": "your_api_secret"
  }'

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Posts

Create, update, and manage your social media posts across all connected platforms.

Create a Post

POST /api/v1/posts
Parameter Type Description
content string Post content (max 2000 chars)
platforms array Array of platform IDs
scheduled_at datetime ISO 8601 timestamp for scheduled publish 
curl -X POST https://api.socialflow.io/api/v1/posts \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Excited to announce our new feature!",
    "platforms": ["twitter", "instagram"],
    "scheduled_at": "2026-04-15T14:30:00Z"
  }'

List Posts

GET /api/v1/posts

Retrieve a paginated list of posts with optional filters.

curl https://api.socialflow.io/api/v1/posts?status=draft&limit=20 \
  -H "Authorization: Bearer YOUR_TOKEN"

Schedules

View and manage your content calendar. Get optimal posting times based on your audience engagement patterns.

GET /api/v1/schedules 
curl https://api.socialflow.io/api/v1/schedules \
  -H "Authorization: Bearer YOUR_TOKEN"
GET /api/v1/schedules/optimal-times

Get AI-powered optimal posting times for your audience.

Analytics

Access detailed analytics and performance metrics for your social media accounts.

GET /api/v1/analytics/overview 
curl "https://api.socialflow.io/api/v1/analytics/overview?period=30d" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

{
  "total_posts": 145,
  "total_engagement": 24500,
  "follower_growth": 1250,
  "top_performing": [
    {"post_id": "abc123", "engagement": 1250}
  ]
}

Accounts

Manage your connected social media accounts and their settings.

GET /api/v1/accounts 
curl https://api.socialflow.io/api/v1/accounts \
  -H "Authorization: Bearer YOUR_TOKEN"
POST /api/v1/accounts/connect

Connect a new social media account to your workspace.

curl -X POST https://api.socialflow.io/api/v1/accounts/connect \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "platform": "instagram",
    "access_token": "INSTAGRAM_ACCESS_TOKEN"
  }'