Getting Started
- Introduction & overview
- How Socialoop works
- Quickstart guide
- Core concepts
Developer Documentation
Build with Socialoop
Everything you need to integrate social media scheduling into your product. Public API, CLI, MCP server, OAuth2, and SDK documentation — all in one place.
# Install the Socialoop CLI
npm install -g @socialoop/cli
# Authenticate
socialoop login
# Schedule a post
socialoop post schedule --platform instagram
Jump to what you need
Start here
Introduction
What Socialoop is and how the platform works.
5 min
Quickstart
Make your first API call in under 5 minutes.
Required
Authentication
API keys, OAuth2, and securing your integration.
Reference
Public API
Full REST API reference — endpoints, params, responses.
Popular
CLI (OpenClaw)
Control Socialoop from the terminal with AI agents.
Integrations
SDKs & Tools
n8n node, Make.com module, and community libraries.
Quickstart
Make your first API call in 5 minutes
01
Get your API key
Go to your Socialoop dashboard → Settings → API → Generate a new API key. Copy it to your clipboard.
SOCIALOOP_API_KEY=sk_live_...02
Connect a channel
Use the API to list and connect a social media account to start scheduling.
GET /api/v1/channels03
Schedule a post
Send a POST request with your content, channel ID, and publish time to schedule a post.
POST /api/v1/postsDocumentation
Everything covered
Full reference documentation for every aspect of the Socialoop platform.
Authentication
- API key setup
- OAuth2 flow
- Scopes & permissions
- Token refresh
REST API Reference
- Posts — create, schedule, delete
- Channels — connect & list
- Analytics — metrics & reports
- Workspaces & teams
CLI (OpenClaw)
- Installation
- Authentication
- Commands reference
- AI agent integration
MCP Server
- MCP overview
- Connecting Claude & ChatGPT
- Available MCP tools
- Configuration
Self-Hosting
- System requirements
- Docker Compose setup
- Environment variables
- Upgrades & migrations
SDKs & Tools
Official SDKs & integrations
Plug Socialoop into your existing tools and workflows in minutes.
Authentication
API keys & OAuth2
Socialoop uses industry-standard OAuth2 for all API access. Generate a personal API key in seconds, or implement the full OAuth2 flow to let your users connect their Socialoop accounts to your product.
Personal API keys for quick integrations
OAuth2 for third-party developer apps
Scoped permissions per integration
Automatic token refresh handling
Webhook signing for secure event delivery
# Authenticate an API request
curl -X GET \
https://api.socialoop.com/v1/channels \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json"
# Response
{
"channels": [
{ "id": "ch_abc123",
"platform": "instagram" }
]
}
FAQ
Developer FAQ
Does Socialoop have a public API?
Yes. Socialoop provides a RESTful Public API that lets you schedule posts, manage connected accounts, retrieve analytics, and automate publishing across 30+ social media platforms.
How do I authenticate with the Socialoop API?
Socialoop uses OAuth2 for authentication. Generate an API key from your dashboard Settings > API, or implement the full OAuth2 flow to allow third-party users to connect their Socialoop accounts.
What is the Socialoop CLI?
The Socialoop CLI (OpenClaw) lets you control your Socialoop account from the terminal — schedule posts, manage channels, and trigger publishing workflows through AI agents like Claude, ChatGPT, or Codex.
Can I self-host Socialoop?
Yes. Socialoop is open-source and can be self-hosted via Docker Compose. The self-hosted version includes all core scheduling, AI, and API features.
Does Socialoop support webhooks?
Yes. Socialoop supports webhooks for post published, post failed, and account connected events — allowing you to trigger downstream workflows in n8n, Make.com, or custom systems.
⚡
Ready to start building?
Get your API key, explore the docs, and ship your first integration in minutes.
Free plan available. No credit card required.