API Quickstart

Get up and running with the SocialRails API in under 5 minutes.

Prerequisites

• A SocialRails account on the Creator plan or higher
• At least one connected social media account
• A terminal or HTTP client (curl, Postman, etc.)

Step 1: Create an API Key

1. Go to Settings > API Keys in your SocialRails dashboard
2. Click Create Key
3. Give it a name (e.g., "My first integration")
4. Select scopes: Read and Write
5. Click Create Key and copy the key immediately, you won't see it again

Your key looks like: sr_live_abc123...

Step 2: Test Your Connection

Verify your key works by hitting the health endpoint (no auth required) and then your workspace:

# Health check (no auth needed)
curl https://socialrails.com/api/v1/health
 
# Verify your API key
curl https://socialrails.com/api/v1/workspace \
  -H "Authorization: Bearer sr_live_YOUR_KEY_HERE"

You should see your workspace name, plan, and limits in the response.

Step 3: Schedule Your First Post

curl -X POST https://socialrails.com/api/v1/posts \
  -H "Authorization: Bearer sr_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the SocialRails API!",
    "platform": "twitter",
    "scheduled_for": "2026-03-03T10:00:00Z"
  }'

Step 4: Verify It Worked

curl https://socialrails.com/api/v1/posts?status=scheduled \
  -H "Authorization: Bearer sr_live_YOUR_KEY_HERE"

You should see your newly scheduled post in the response.

What's Next?

• API Endpoints Reference, Full reference for all endpoints
• Code Examples, Copy-paste examples in JavaScript and Python
• Batch Posting, Schedule to multiple platforms at once
• Rate Limits, Understand request limits for your plan
• Error Handling, Handle errors gracefully