Public API v1

SocialSpool API overview

The SocialSpool public API lets you create drafts, schedule posts, publish to connected social accounts, inspect workspace state, and receive webhook events for everything that happens to a post.

OpenAPI JSON
What you can do

Every endpoint is scoped to a single workspace and authenticated with a workspace API key. The API is RESTful, returns JSON, and uses standard HTTP status codes.

  • Verify that an API key is valid and inspect its workspace.
  • List the social accounts connected to a workspace.
  • Create, list, edit, schedule, publish, and cancel text posts.
  • Receive signed webhook events for post lifecycle changes (created, scheduled, queued, published, failed, canceled).
Base URL and versioning

All endpoints are mounted under /api/v1. The base URL is the same origin that hosts the SocialSpool dashboard.

Backwards-compatible additions (new fields, new event types, new endpoints) ship under the same v1 prefix. Breaking changes will ship under a new prefix.

Request format

All write requests use Content-Type: application/json and a JSON-encoded body. Timestamps are ISO 8601 strings in UTC. Identifiers are opaque strings.

Successful responses return the resource or a list wrapper. Errors always return { "error": { "code", "message", "details" } }.

Where to go next