SocialSchedule API — Programmatic Social Media Scheduling

The SocialSchedule API is a social media scheduling API for multi-platform publishing: authenticate workspaces, upload media, create scheduled posts, manage queues, receive webhooks, and pull analytics—without waiting on an enterprise add-on.

Start free

Code samples

Samples stay in English — copy into your terminal, MCP client, or skill file.

Auth headers

Authorization: Bearer ssk_live_xxx
X-Workspace-Id: ws_abc123

Create post

curl -X POST https://api.socialschedule.ai/v1/posts \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram", "tiktok"],
    "caption": "New drop is live",
    "mediaIds": ["media_01"],
    "scheduledFor": "2026-04-02T18:00:00Z",
    "utm": {
      "source": "instagram",
      "medium": "social",
      "campaign": "spring-drop"
    }
  }'

Upload media

curl -X POST https://api.socialschedule.ai/v1/media \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -F "file=@./product.mp4"

Create webhook

curl -X POST https://api.socialschedule.ai/v1/webhooks \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/socialschedule",
    "events": ["post.published", "post.failed"]
  }'

CLI MCP Skills

Authentication and workspaces

Use bearer tokens scoped to a workspace. Pass workspace identifiers for multi-tenant agency apps. For developers and AI agents, “Authentication and workspaces” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Rotate keys and prefer least privilege. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Mirror the same permission model as the web app. Curl samples below remain English/technical by design. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Create, update, and cancel scheduled posts

CRUD endpoints cover the full lifecycle of a scheduled post. Idempotency keys help safe retries. For developers and AI agents, “Create, update, and cancel scheduled posts” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Cancel or reschedule when campaigns slip. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Support drafts versus scheduled states explicitly. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Conceptual API patterns

Authenticate with a workspace-scoped bearer token. Create posts with platform targets, caption variants, media IDs, and schedule timestamps. Use idempotency keys on retries.

Example shape (illustrative): `POST /v1/posts` with `{ "platforms": ["instagram","x"], "body": "...", "mediaIds": [...], "scheduledAt": "..." }`. Subscribe to `post.published` / `post.failed` webhooks for ops alerts.

Prefer draft → approve → schedule for brand safety. Rate-limit with backoff on 429s. Full OpenAPI details ship with your developer workspace.

Media upload and platform-specific payloads

Upload media, then reference media IDs from post create calls. Attach platform-specific fields where networks require them. For developers and AI agents, “Media upload and platform-specific payloads” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Validate aspect ratios before launch day. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Reuse media across platform variants when appropriate. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Calendars, queues, and optimal-time helpers

List calendar windows and enqueue posts for optimal posting times. Build internal tools that show the same week marketers see. For developers and AI agents, “Calendars, queues, and optimal-time helpers” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Fill gaps programmatically after analytics reviews. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Combine with Skills for higher-level planning. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Analytics endpoints that matter

Fetch engagement and delivery metrics for scheduled content. Power client portals and internal dashboards. For developers and AI agents, “Analytics endpoints that matter” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Avoid vanity-only reporting in automated emails. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Close the loop into next week’s generation jobs. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Webhooks for published / failed events

Subscribe to post.published and post.failed events. Drive Slack alerts or ticketing when publishes fail. For developers and AI agents, “Webhooks for published / failed events” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Verify signatures before trusting payloads. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Keep webhook handlers idempotent. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Rate limits, idempotency, and best practices

Respect rate limits; backoff; retry with idempotency keys. Log correlation IDs for support. For developers and AI agents, “Rate limits, idempotency, and best practices” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Prefer draft→approve→schedule for brand safety. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Document your internal automation runbooks. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

API quickstarts for common platforms

Common paths include scheduling Instagram posts via API, LinkedIn company updates, and multi-platform launches. Start with one platform integration test, then expand. For developers and AI agents, “API quickstarts for common platforms” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Agencies can build client portals on the API. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

MCP may be faster for agent UIs; API wins for your backend. Create an API key in the app and ship your first scheduled post. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Frequently asked questions

Does SocialSchedule offer a public API?+

Yes. The SocialSchedule API supports programmatic scheduling, media, queues, webhooks, and analytics.

Can I schedule Instagram posts via API?+

Yes, for Instagram accounts connected to your workspace (subject to platform policies and permissions).

Which platforms are supported in the API?+

Platforms available in SocialSchedule—Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, Google Business Profile—when connected.

How does authentication work?+

Use a bearer API key scoped to a workspace. Keep keys in a secrets manager.

Are there webhooks for publish events?+

Yes. Subscribe to published and failed events for operational alerting.

Can I fetch analytics through the API?+

Yes. Pull metrics to power dashboards and automation loops.

What are the rate limits?+

Rate limits apply per workspace/token. Backoff on 429s and use idempotency keys for safe retries.

Is there an official SDK?+

Start with the REST API and curl examples; SDKs/community clients may be added as the surface stabilizes.

How does the API compare to the MCP server?+

API is ideal for your servers and products; MCP is ideal for AI agents that tool-call interactively.

Can agencies build client portals on the API?+

Yes. Many agencies wrap the API for client-facing calendars and approvals.

How do I upload media?+

Use the media upload endpoint, then reference returned media IDs when creating posts.

Where is the OpenAPI / reference docs?+

Use this guide for quickstarts; full OpenAPI details ship with your developer workspace documentation.

Create an API key and schedule programmatically

Multi-platform publishing with webhooks, queues, and analytics.